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Preface 



MANUAL OBJECTIVES 



The IPjU -HM Reference Manua l is a manual describing the 
structure and use of the SPM-11M software supported by DIGITAL 
on RSX- 1 1M operating systems. 



INTENDED AUDIENCE 

This manual is for all users of SPM-11M 



STRUCTURE 
Chapter 1 
Chapter 2 
Chapter 3 
Chapter 4 
Chapter 5 
Chapter 6 
Chapter 7 
Appendix A 
Appendix B 

Ap pend i x C 
Append i x D 
Appendix E 
Append i x F 
Appendix G 
Appendix H 



OF THIS DOCUMENT 

is an overview of the architecture of SPM-11M. 
describes the components of SPM-11M. 
describes how to use SPM- 1 1M . 

describes data collection and reducti on procedures 

describes how to read the pe r f o rmance report. 

delineates the resources used by S PM- 1 1M . 

is the usage notes for SPM-11M. 

is a specification of the Hook Records . 

is a specification of the Mon i tor Parameter Block 
(MPB ) . 

is a specification of the Information Records. 

is a speci f ication of the System Metrics Record . 

is a specification of the logfile format. 

is a sample perf o rmance report. 

is a sampl e SMPGEN.CMD p rocedure . 

is a sample of installation of SPM-11M. 
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Chapter 1 

OVERVIEW OF SPM-1 1M 



The Software Performance Monitor (SPM-11M) is a software 
instrument used to measure the performance of a computer system 
running the R S X - 1 1 M operating system. 

S P M - 1 1 M is a natural counterpart to RSX-11M: while R S X - 1 1 M 
manages the resources of the computer system, SPM-11M remembers 
how the resources were used over a period of time, similar to 
the way a tape recorder remembers a set of sound patterns . 
Moreover , SPM-11M has the capabi 1 i ty of "pi ay i ng back " these 
record i ngs of resource usage, so a n analyst can study how and 
when the resources were used . 

SPM-11M is a n event driven performance monitor. As each event 
o f interest occurs , the performance monitor is called. 



1.1 RESOURCES 

The key resources of interest are : 
o CPU 



o Main memory 



o I / de v i ces 
o File system 
o Task loader 



Note that a resource can be a h a rdwa re resource - - such as the 
CPU , main memory or an I / device; or a software resource 
such as the file system or the task loader. 
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1.2 USERS 



A user is the entity which uses the resources managed by the 
operating system. We define a user to be a n RSX-11M task". Of 
prima ry concern is the workl oad the task places on the system, 
that is, how much and for how long the resources a re used. To 
describe a task's workl oad we will define a set of metrics for 
resou rce usage . 



1 . 3 RESOURCE MODEL 

Because a number of tasks may concurrently request the use of a 
resource , and only one task may use the resou rce at a time , a 
queue will form for the resource. A simple queued resource is 
depicted as follows : 



w 



The vertical bars represent the queued resource requests and 
the square rep resents the resource. Three intervals are shown 
on the diagram. " W " denotes the interval during which a task 
is waiting for the resource. "U" denotes an interval when a 
task is using the resource. "S" is the sum of "W" and "U", 
called the service time. 



1.4 EVENTS 

The acti vi ty of the RSX- 1 1M operating system can be traced by 
defining a set of key events and recording a set of raw infor- 
mation associated with each event. The events of interest are 
those which capture the metrics of resource usage . 

For exampl e , we may want to know how long a task waits for the 
disk, how many times it uses the disk and how long it uses the 
disk. The following events are defined to capture the I / 
act i v i ty : 

1 . Queue I / packet to driver 

2. Driver gets I/O packet 

3 . Driver posts I / completion 
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Applied to the queued resource model for the disk, these I/O 
events appear as follows : 



1 2 3 

The compl ete set of events defined for RSX-11M is specified in 
Append i x A , 



1.5 TASK METRICS 

The task metri cs quanti fy the workload that individual tasks 
place on the system. ■■* 

The task metrics are computed for all three types of intervals: 
U , W and S. The performance report will contain a line of task 
metrics for each resource used by the task. The task metrics 
are: 

o Count 

A simple metric for resource usage is a count of the 
number of times the resource was used during the life 
of a task. For example , if a task does four QIOs to a 
disk, the I / request count is four. 

o Total Time 

Another simple metric is how long the task uses a 
resource. For exampl e , if a task did four Q I Os and 
the I/O requests took 20ms , 60ms , 1 0ms and 50ms to 
complete, the total usage time woul d be 140ms . 

o % Resident Time 

Also of importance is what percentage the total usage 
time is of the time the task was in memory. For 
examp 1 e , if the previous task was in memory ' for one 
second the percentage of res i dent time spent using the 
disk was 140ms/ 1000ms * 100% = 14%. 
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o Interval Statistics 

The statistical nature of the usage time is of key 
i mportance . 

The met r i cs defined for i nterval statistics are: 

Minimum interval 

Mean (average) interval 

Maximum interval 

Coefficient of Variation 

The coefficient of variation is the standard deviation 
of the intervals divided by the mean interval. 

The coefficient of variation is of particular impor- 
tance because it t e 1 Is whether the data is cl ustered 
about the mean (small c.v.) or widely scattered about 
the mean (large c.v.)- I n fact , if the c.v. is large, 
the mean may tell very little about the nature of the 
data , since very small values and very large v a 1 u e s 
may combine to produce a mean which is not represen- 
tative o f any real value. 



1.6 SYSTEM METRICS 

The task workload metrics defined above are useful for deter- 
mining who is using the system resources and how much each user 
i s cons umi n g . 

Also of importance is the performance of the system as a whole. 
To this purpose we define a set of system metrics. 

The system metrics vary a s a function of time. To see how a 
given system met r i c varies with time, hi stograms are computed 
for the metric. Each histogram des c r i bes the per cent usage of 
a resource for one sampling interval . The sampling interval is 
a settable parameter descri bed in Chapter 3 , section 3.2.1. 



CPU 



The CPU can be in one of three general states: 



o 



User 



o 



Kernel (system) 



o 



Idle 
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A useful metric is the per cent of time spent in each state, 

that is: 



o % time in user state 

o % time in kernel state 

o % time in idle state 

This gives us a general picture of how effectively the CPU is 
being utilized ( % time in user state + % time in kernel state) , 
as well as the overhead imposed by the operating system ( % time 
i n kernel state) . 

Memory 

On RSX-11M the memory space is divided into partitions. The 
user can select one system-controlled partition for monitoring 
by SPM- 1 1M . The performance monitor will compute the per cent 
of the partition that was in use at the end of each sampling 
interval and print a histogram. 

The user will most commonly select the partition "GEN" for 
monitoring. 

I / Devi ces 



The user can select one I/O device to be monitored by SPM- 1 1M 
for system-wide usage. SPM- 1 1M will compute the percent of 
time the device was utilized for each sampling interval and 
print a histogram. If the device is mounted Files-11, SPM-11M 
will compute the percent disk space used at the end of each 
sampling i nte rva 1 and print a histogram. 

Pool 



The RSX-11M system pool contains the dynamically allocated data 
structures used by the executive. SPM- 1 1M will compute the per- 
cent of pool that was in use at the end of each sampling 
interval and print a histogram. 

Checkpoi nt file(s) 

SPM-11M will monitor checkpoi nt files allocated by the ACS 
command . The performance monitor will compute the per cent of 
all active checkpoint file space in use at the end of each 
s a m p 1 i n g interval and print a histogram. 
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■ 



Ohdptor 2 



THE COMPONENTS 
OF SPM-1 1M 



The SPM-11M performance monitor consists of two main compo- 
nents : the Data Collection Component and the Data Reduction 
Component. The Data Collection Component records the resource 
usage events of the operating system to a log file; the Data 
Reduction Component reads the 1 ogf i 1 e and produces a perfor- 
mance report suitable for analysis. 

This general architecture is depicted in Figure 1 . 



RSX-11M 



Data 
Collection 
Component 



LogFile 



Data 
Reduction 
Component 



Performance 
Report 



Figure 1 
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By decoupling the Data Collection Component from the Data 
Reduction Component in time, the performance moni tor can 
collect detailed information about a huge number of events, 
albeit in a raw format . The Data Reduction Component can then 
be used to selectively analyze and f i iter the i nf ormati on in 
the 1 ogf i 1 e to produce a performance report. This architecture 
shifts the computational aspects of the performance monitor 
from the Data Collection Component to the Data Reduction 
Component . The benef i t derived is that the performance mon i tor 
uses less CPU time , thus minimizing its i nte rf e rence with the 
CPU. The cost is more I / activity, which in most systems can 
be d i rected to a seconda ry mass storage device not in the path 
of the major stream of I / act i v i ty . 



2.1 DATA COLLECTION COMPONENT 

The Data Coll ecti on Component consists of both software and 

ha rdwa re distributed in various places within an RSX-11M 
system. 

The basic pieces of the Data Collection Component are: 






Hooks 







Hook Di spatcher 







Hook Routines 







Hook Records 







KWll-P Clock and 


Handler 





Hook Buffers 







Log f i 1 e 







Data Col lection 


Task ( . . .COL) 





Termi nati on Task 


( . . . TRM ) 





COL Message Task 


(COLMSG) 



The relationship between these pieces is s hown in Figure 2 . 
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DATA COLLECTION COMPONENT 



ISX-11M 



BSD 




Hook 
Dispatcher 



KW1 1-P 
Handler 




COL TASK 



Hook 
Routines 



Monitor 
Parameter 
FILE 



BUFFER 

partition 



Hook 
Record 



LOGFILE 



Figure 2 



Heuristic Procedure for Data Collection 



At this point a heuristic procedure for data collection will be 
given, although the terms used in the procedure have not been 
precisely defined. 
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When a resource usage event occurs in R S X - 1 1M , the corre- 
sponding hook calls the hook di spatcher , which uses the hook I D 
t o call the appropriate hook routine. The hook routine 
col 1 ects information rel evant to the hook and assembles it into 
a hook record , which resides in a hook buffer. When a hook 
buffer is filled with hook records , it is written to the 
1 og f i 1 e . The 1 ogf i 1 e is closed a t the end of the measurement 
interval , and subsequently reopened by the Data Reduction 
Component . 1 1 reads the hook records and uses them to derive 
the resource usage metrics and print a performance report . 

The details of these pieces will now be devel oped more f u 1 1 y . 



2.1.1 Hooks 

A hook is simply a n implementation technique for captu ring a 
resource usage event. For SPM-11M, a hook is implemented as a 
subroutine call inserted at the point in the operating system 
where the event occurs . The subroutine call passes control and 
one argument , the hook I D , to the hook dispatcher. The form of 
a n SPM-11M hook is as follows : 

CALL @$HKDSP 
•WORD H$XXXX 

where X X X X is mnemonic identifying the particular hook. A 
compl ete specification of a 1 1 hooks is given in Append i x A . 



2.1.2 Hook Dispatcher 

Hooks are resident within the operating system; their method of 

insertion is addressed in Chapter 3 , section 3.1.3. However , 

most o f the code and database for the Data Collection C ompon e n t 
is not resident within the RSX-11M executive. 

The bulk of the data col lection code is resident in the data 

collection task ca 1 led COL (tas kname is ...COL). The chief 

benefit derived from this design is that only a small amount of 

executive space (which translates d i r e c 1 1 y to the critical 
resource: pool) is used by the performance monitor. 

The purpose of the hook dispatcher is to map and call the hook 
routines which are resident in the COL task. Note that, though 
the hook routines are resident in the task partition for COL , 
they are executed in the context of a directive or interrupt 
service routine. The hook di spatcher is resident in pool , is 
allocated when COL is activated, and is deal 1 ocated when COL 
exits. The hook dispatcher is analagous to a n I C B for a 
loadable driver. 
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A one word dispatch vector labelled $HKDSP is added to system 
common (SYSCM). This word points to the entry point in the 
hook di spatcher res i dent in pool . It is the port through which 
all hooks pass control from the RSX-11M executive to the Data 
Collection Component of the performance mon i to r . 



2.1.3 Hook Routine 

A hook routine copies i nf ormati on which is generally scattered 
about the executive (typi cal ly in SYSCM or SYSTB ) into a hook 
record which is res i dent in a static common or dynami c region. 
A timestamp is also recorded in the hook record. 

There are two general types of hooks : task and system. The 
task hooks collect data rel evant to resources used by tasks ; 
the system hooks coll ect data which is system -wide (e.g. , % CPU 
time in user, kernel and idle). 



2.1.4 Hook Record 



The i nf ormati on col 1 ected at each hook is formatted into a hook 
record. The hook record provides an identical representation 
of a hook's information content both in memory and in the 

1 o g f i 1 e . 

Each hook record contains both generic and hook-specific data. 
Generic data applies to al 1 hooks. Generic data consists of : 



o Hook ID 



o Taskname 
o Timestamp 

o Task's TI (UCB address ) 

Hook specific data applies to only one or a smal 1 subset of the 
hooks. For example, the H$CDRP (call directive processor) hook 
records the directive I D code as hook-specific data . 

Appendix A specifies the information content of the hook 
records . 
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2.1.5 KWll-P Clock and Handler 



For precise performance measurements, SPM-11M needs a high 
speed clock running independent of the R S X - 1 1 M system clock. 
1 1 is therefore a requ i remen t that a KW1 1-P clock be installed 
on a machine runni ng SPM-11M. This KW11-P clock must be in 
addition to the RSX- 1 1M system clock, be it a KW11-L or KW11-P. 

The KW11-P is initialized by the COL task to run at 100 kHz 
( 1 microsecond ticks) and to interrupt every 65536 ticks 
(approximately every 0.65 second) . 

The K W 1 1 - P clock time is maintained as as 2 word ( 3 2 bit) value 
which , a t a rate of 100 kHz, wi 1 1 overf 1 ow in a little over 
11.5 hours . 



To preclude the possibility of overflow of the KW11-P clock 
time, a maximum measurement interval of 11.5 hours has been 
established. The task COL enforces this by setting an 11.5 
hour mark-time when activated. If the timer expires, COL will 
stop data collection and exit. 



The COL task allocates a piece of system pool and links it to 
the KW1 1-P clock vector. This pool node serves as the clock 
i nterrupt handler, which updates the high order clock time 
located in SYSCM at $PC LKH . The low order clock time is not 
stored in memory; rather, each hook routine copies the current 
contents of the KWil-P clock's count register to the hook 
record directly to get the 1 ow order t i me word. 



2.1.6 Hook Buffer 

Hook records are stored in buffers which are resident in either 
a static common or a dynami c region. When a hook buffer is 
full , the hook routine sets a n event flag which signals the COL 
task to write the buffer to the logfile. 

The hook buffers are linked together into a circular list. 
There may be from 2 to 8 buffers in a list, and a 1 1 the buffers 
must be of the same length. A buffer may be from 256 words to 
4096 words long. 

I f the buffers are resident in a static common , the maximum 
size common which can be used is 4096 words . This 1 imitation 
is i mposed because the COL task uses one APR to map the static 
common . 

I f the buffers are res i dent in a dynami c region , the region can 
be from 512 words to 32K words long. 
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2.1.7 Logfile 

The 1 ogf i 1 e contains four types of records: 

o Monitor Parameter Block ( MPB ) 

o Information Records 

o Hook Records 

o System Metric Records 
See Append i x E for a specification of the log file. 



Mo nit o r Parameter Block 

The Monitor Parameter Block ( MPB ) is used by the COL task to 
initialize its meas u rement parameters. The MPB is formatted as 
an Information Record with record type I $ M P B . A detailed 
descri pti on of the MPB is given in Append i x B . 

The MPB is generated by a command file called SMPGEN.CMD. See 
Chapter 3, section 3.2.1 for details. 



Inf ormati on Reco rds 

The Inf ormati on Records are used to s uppl ement the Hook Records 
in the logfile with system context useful to the Data Reduction 
Component . 

When COL starts up it reads the MPB from the MPB f i 1 e and 
writes it to the logfile. Following the MPB , COL writes a 
stream of I n f o rmat i on Records which contain a number of RSX-11M 
data structures defining the initial system state. Thes e data 
structures are: 

o Task Control Block ( TCB ) 

o Pa rt i t i on Control Block ( PCB ) 

o Device Control Block ( DC B ) 

o Unit Control Block (UCB ) 

Each data structure is copied to a sepa rate I n f o rmat i on Record. 



When COL begins a measurement 
t i o r ) , it records the R S X - 1 1 M 
SPM-11M time (KW11-P time) to an 



interval (starts data col 1 ec - 
system time as well as the 
Information Record ( I $TMR ) . 
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When COL ends a measurement i nte 
copies the R S X - 1 1 M system time, 
in kernel state and CPU time 
Information Record ( I $ S T M ) . 

A complete specification of a 1 1 
Append i x C . 



rval (stops data collection) it 
SPM-11M time, CPU time accrued 
accrued in idle state to a n 



Information Records is given in 



Hook Re cords 

As each hook point is encountered in the executive, a Hook 
Record is written to the logfile. See section 2.1.4 for 
details. 



System Metrics Record 

At the end of each sample interval , a Sy s tern Metrics Record is 
written to the logfile. This record contains i nf ormati on which 
describes the system-wide usage of the sel ected resources. 

The System Metrics Reco rd is specified in Append i x D . 



Logfile Med i a 

The logfile can be resident on disk a s a F i 1 e s - 1 1 f i 1 e or on 
magtape as a sequence of tape records . 

I f the logfile is resident on disk, it consists of a sequence 
o f virtual blocks (virtual block = 256 words) . The records 
within these v i r t u a 1 blocks are defined according to the record 
definitions for the MPB , Inf ormati on Records , Hook Records and 
System Metric Records. Note that the logfile does not have any 
other record structure (such a s FCS or RMS type records ) . 

If the logfile is on a magtape, the MPB , Information Records 
and Hook Records are imbedded in a stream of tape records . 
Each tape record is equal in length to a hook buffer. 



2.1.8 Data Collection Task (...COL) 

This section gives a functional description of the COL task, A 
guide to using COL is provided in Chapter 3, secti on 3.2.2. 

As noted before , this task contains both code which executes in 
executive context (as a directive or i nterrupt process) and 
code which executes in the context of a privileged task. The 
code which executes at executive level is the hook routines. 
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2.1.8.1 COL Executive Level Code - 

The hook routines were made a part of the COL task for a number 
of reasons : 

o They must be resident in some partition outside of 
executi ve space . 

o They can easily be loaded as part of the COL task. 

o They impl ement routines which are common to hooks and 
to the COL task. 



2.1.8.2 COL Task Level Code - 

Most of the COL task consists of code which is executed at task 
1 evel . The major f uncti ons of the COL task are: 

o Initialization 

o Starting data collection 

o Writing to 1 ogf i 1 e 

o Stopp i n g data col 1 ecti on 

o CI eanup 

2.1.8.2.1 Initialization - 

When COL begins execution , there is very little SPM-11M code 
elsewhere in the system. Al 1 that exists are the hooks in the 
executive which all call a dummy return subroutine in SYSXT. 
1 1 is the job of COL to initialize a 1 1 code and databases 
required for the SPM-11M performance monitor. The specific 
sequence of initialization functions performed by COL are: 

o Read MPB file and store MPB in COL buffer . 

o Create dynami c region (if necessary) and set up ring 
o f hook buffers . 

o Write MPB and Information Records (RSX-11M data 
structures) to logfile. 

o Mark COL task a s fixed in memory and nonshufflable. 

o Initialize hooks specified in MPB . 
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Allocate pool node for hook dispatcher and copy code 
t o pool node. 



o Al 1 ocate pool node for KW11-P clock handler and copy 
code to pool node . Link pool node to KW11-P clock 
vector. 

o Initial i z e K W 1 1 - P clock and turn it on . 

o Initialize measurement parameters as specified in MPB . 



2.1.8.2.2 Starting Data Collection - 

When data collection is disabled , the hook dispatch vector 
$HKDS P points to a dummy routine in S YSXT which simply steps 
over the hook ID and returns to the instruction in the 
executive following the hook. 

Just prior to starting data col lection , COL writes a "start 
data col lection" Inf ormati on Record ( I $TMR ) to the hook buffer . 

To enable data col lection the COL task simply points the hook 
dispatch vector $HKDSP to the hook dispatcher code resident in 
pool . 



2.1.8.2.3 Writing Hook Records to Logfile - 

The steady state function of the COL task is to write Hook 
Records to the logfile. When a hook routine f i I I s a hook 
buffer , it sets a n event flag for COL which wakes COL from its 
wait state. COL then writes the hook buffer to disk or magtape 
(waiting for completion of the write) , and loops to see if 
another hook buffer is ready to write. When no more hook 
buffers are outstanding , COL returns to the wait state. 

If the hook buffers fill up too rapidly for COL to write them 
to the logfile, COL wi 1 1 set the overf 1 ow status bit. I f the 
overflow status is set when a measurement i nterval expires , COL 
will print a status message on the console device (CO :) . In 
general , the data collected during a measurement interval 
should not be used for data reduction if the overflow condi ti on 
occurred. 



2.1.8.2.4 Stopping Data Collection - 

To stop data col 1 ecti on , COL merely points the hook dispatch 
vector $HKDSP to the dummy routine at $H KE XT in SYSXT . It then 
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writes a stop data collection Information Record ( I $ S T M ) to the 
hook buffer . Any outstandi ng records in the hook buffer will 
be written to the logfile. 



2.1.8.2.5 Cleanup - 

Before COL exits , it must rel ease any sys teni resources it has 
allocated and deactivate any hardware it has turned on. The 
following actions are thus performed: 

o Turn off KW11-P clock. 

o Deallocate pool nodes for hook dispatcher and KWI1-P 
clock handler. 

o Unfix COL task. 



2.1.9 Termination Task ( . . . T R M ) 

The purpose of the termi nation task ( . . . TRM ) is to signal the 
COL task to stop data col 1 ecti on and exit. TRM provides a way 
t o manual ly terminate the COL task, as opposed to automatic 
shutoff by timeout or buffers (see Chapter 3 , section 3.2.1). 



2.1.10 COL Message Task (COLMSG) 

The COL message task contains the ASCII text for the error 
messages issued by the COL task. If the COLMSG task is i n s t a 1 - 
led and a COL error occurs , the full error message text wi 1 1 be 
printed. I f a COL error occurs and the COLMSG task is not 
installed, the COL task will print an error number which can be 
correlated with the correct error message in Chapter 3 , section 
3.2.2. 



2.2 DATA REDUCTION COMPONENT 

The main purpose of the Data Reduction Component is to read the 
raw data from the logfile (hook records) and produce a perfor- 
mance report detailing the resources used by the various tasks 
in the system. 

The Data Reduction Component accomplishes this in a multi-step 
process involving two tasks: 

o Moni tor Data Reduction ( MDR ) Task 

o DRS Tas k 
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There are three major steps in the data reduction process : 

1. Map Hook Records to Task Workload Records and generate 
system -wide metrics section of performance report ( MDR 
Pass 1 ) . 

2. Sort Task Workload Records (DRS) . 

3 . Summarize Task Workload Records and generate task 
metrics section of performance report ( MDR Pass 2). 



The Task Workload Records are intermediate data structures 
which contain the data collected for each task and each 
resource used by the task. 

This general p rocedu re is depicted in Figure 3. 



DATA REDUCTION COMPONENT 



TRACE . LOG 



Hook 
Record 




RESOURCE. 7MP 



Task Workload 
Record 





Figure 3 
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From the figure we see there are four databases which are 
processed by the two tasks: 

o TRAC E . LOG (logfile containing Hook Records ) . 

o RESOURCE. TMP (intermediate file containing unsorted 
Task Workload Records). 

o RESOURCE . SRT ( i n te rmed i ate file containing sorted Task 
Work! oad Records . 

o REDUCE. RPT (final performance report) . 



2.2.1 MO R Pass 1 

MDR reads hook records from the logfile (default name is 
TRACE .LOG) and maps the information to the Task Workload 
Records in the intermediate file RESOURCE .TMP. 



2.2.2 DRS Pass 



DRS sorts the Task Workload Records using the f ol 1 owi ng three 
keys : 



o Generic Taskname 



o Task's TI UCB address 



o Task start time. 



NOTE : By "generic tas kname " we mean the installed taskname of 
a multiuser task. For example, the generic taskname for 
the task PIPT5 is ...PIP. I f the task is not multiuser, 
generic taskname is simply the run time taskname . 



The three keys 1 i s t e d above are concatenated into one "big" 
key , with the generic taskname forming the highest order part 
of the key, the Task's T I UCB address f ormi ng the middle order 
part o f the key , and the Task start time forming the low order 
part o f the key. The DRS task sorts a 1 1 the Task Workload 
Records using this one big key. With this technique the DRS 
task only needs to do one sort operation on the file 
RESOURCE .TMP . 
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When DRS is done sorting the Tas k Workload Records , the records 
will be arranged as follows: 

o All records with the same generic tas kname will be 
clustered together. 

o Within a generic taskname cluster, all records with 
the same TI will be clustered together. 

o Al 1 records within a taskname-TI cluster will be 
sequenced by ascending task start time. 

DRS writes the sorted Task Wo r k 1 o a d Records to the file 
RESOURCE. SRT. 



2.2.3 MDR Pass 2 

MDR reads the Task Workl oad Records from RESOURCE . SRT and 
generates a performance report. A description of the 
performance report is given in Chapter 5 . 
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Chapter 3 

GUIDE TO USING SPM-11M 



3.1 INSTALLATION 



3.1.1 



SPM-11M Kit 



The SPM-11M kit is distributed on 800 BPI magtape, 
all the files necessary to install and use SPM-11M. 
are in DOS tape format. When copied to disk, the 
occupy approximately 900 disk blocks. 



It contai ns 
The files 
files will 



The command file PM0NCPY.CMD can be used 
from tape to tape, tape to disk, disk to 
All files are contained in the directory 
of the kit are: 



to copy 
tape or 
[11 ,2]. 



the kit files 
disk to disk. 
The contents 



Component 

Kit copy command file 

SPM-11M mini-reference guide 

MPB GEN command file 

Macro definition prefix file 

Executive source correction command 

Executive source correction files 

F11ACP patch command file 

F11ACP patch source 

COL/TRM build command file 

COL overlay descriptor file 

COL/TRM object 1 i brary 

MDR object library (EIS version) 

MDR object library (FPP version) 

MDR/CLF build command file 

Data reduction sort task 

DRS map file 

DRS sort command file 

CLF task 

CLF map file 

OVL object 1 i brary 

OVL task 

OVL map f i 1 e 



Fi 1 e 

PMONCPY.CMD 
SPM .DOC 
SMPGEN.CMD 
HKMAC .MAC 
file PMONSLP.CMD 
*.C0R 

PMONPAT.CMD 
FIOSUB .PAT 
PMONBLD.CMD 
COLBLD.ODL 
COL.OLB 
MDREIS .OLB 
MDRFPP . OLB 
MDRTKB .CMD 
DRS .TSK 
DRS .MAP 
DRS .CMD 
CLF. TSK 
CLF .MAP 
OVL. OLB 
OVL .TSK 
OVL. MAP 
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3.1.2 Prerequisites to Installing SPM-11M 
COL Prerequisites 

The following are the prerequisites for running the COL task: 

o Mapped System 

SPM-11M can only be installed on a mapped RSX-11M 
system. 

o Get Partition Parameters Directive 

The COL task will only work if support for the Get 
Partition Parameters (GPRT$) directive is generated 
into the executive. 

o AST Support 

The COL task will collect System Metrics only if AST 
support is generated into the executive. 

o Send and Receive 

The COL task will issue full ASCII error message text 
via the error message task COLMSG if support for Send 
and Receive is generated into the executive. 

o PLAS Support 

If PLAS support is not generated into the executive, 
the COL task buffering is limited to a maximum of a 4K 
word static common. 

If PLAS support is generated into the executive, the 
COL task buffering may be in a dynamic region up to 
32K words long. 



MDR Prerequisites 

MDR requires the following features of the system where it is 
run : 

o EIS instructions 

o support for the executive directives: ASTX$ , E XTK$ , 
GPRT$ , GTS K$ . 

o checkpointing to a dynamically allocated system 
checkpoint file. 
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3.1.3 Installing SPM- 1 1M 

To install SPM-11M, you must start with 






An 


RSX- 


11M 





An 


RSX- 


11M 





An 


SPM- 


1 1M 



To install SPM-11M you must perform an RSX-11M SYSGEN. A 
SYSGEN is required because source code for SPM-11M is inserted 
into the RSX-11M sources. SPM-11M source code is added to the 
following RSX-11M source modules: 



SPM-11M Function 

SPM-11M Macros and Definitions 

Hooks 

Additional Stack Space 

Common Database 

Dummy Hook Return Routine 



RSX-11M Modules 
RSXMCO ,RSXMC 

DRDSP ,DRQI0 ,DRE IF ,DREXP , 
DRSUB ,REQSB ,SYSXT , I OSUB , 
LOADR 



LOWCR 
SYSCM 
SYSXT 



The SPM-11M installation procedure consists of the following 
steps: 



o 
o 






Copy RSX-11M V4.0 kit to baseline disk. 
Perform autopatch to current level (if any). 
Assign SY: to the baseline disk. 

Choose a directory to which you want the SPM-11M kit 
files copied. This will be your SPM-11M kit 

di rectory . 
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Assuming the SPM-11M directory is [g,m] 
>SET /UIC = [g ,m] 
>UFD SY :[g ,m] 

>FLX =ddn : , 2lPM0NCPY.CMD 
>@PM0NCPY 

APPLY CORRECTIONS TO EXECUTIVE SOURCES? Y 

e 

• 

APPLY PATCH TO F11ACP DISPATCHER MODULE (FIOSUB)? Y 
@<EOF> 

>@[200 ,200]SYSGEN 
>@[200 ,200]SYSGEN2 

NOTE: If the patch to F11ACP fails (checksum error), 
SPM-11M will only calculate service times for 
F11ACP. If the patch succeeds, SPM-11M will 
generate usage, wait and service times. 

If PLAS is not generated into the executive, 
create a static common up to 4K words long with 
VMR to provide space for the COL buffers. 

If y° u d n 1 elect to correct the executive 
sources or patch F11ACP via PM0NCPY.CMD you can 
do so later via the command files: 

1) @PM0NSLP for executive source corrections 

2) @PM0MPAT for F11ACP patch 



When the SYSGEN completes, perform the following 
steps: 

>SET /UIC=[g,m] 

XPPMONBLD 
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NOTE: Be sure to taskbuild COL using the baseline 
library [1 ,1]SYSLIB.0LB (without ANSI or big 
buffering FCS routines). Otherwise COL will be 
greater than 4096 words and wi 1 1 not be able to 
map its buffers v i a APR6 . 

The command file will pause if you desire to 
edit the build f i 1 e s for CLF, OVL , or MDR . This 
will allow modifications to defaults for these 
programs . Instructions are i nc 1 uded in the 
build files. 

You can build the MDR , OVL , or CLF tasks 
separately from PMONBLD.CMD by invoking the 
command file MDRTKB.CMD. 

On systems with an FPU the file MDREIS.OLB is 
not needed and may be deleted. On systems 
without a n F P P , the file MDRFPP. OLB is not 
needed and may be deleted. The file may be 
deleted before starti ng the SYSGEN. 



You are now ready to run @ S M P G E N to generate an MPB 
and run COL . This procedure is described in the next 
secti on . 
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3.2 OPERATION 



3.2.1 Generating the Monitor Parameter Block ( MPB ) 

The MPB is the structure which contains the measurement 
parameters . 

To create an MPB you invoke the command file SMPGEN.CMD. 
See Appendix G for an exampl e SMPGEN . 
The procedure is as follows: 

>SET /UIC=[g ,m] 

>@ SMPGEN 

where [g ,m] is your SPM-11M kit d i rectory . 

The MPB is created in the following way : SMPGEN c reates a 
source file (default filespec is TRACE. PAR), assembles and 
builds the code in the file to produce a binary MPB file 
(default filespec is TRACE. MPB). It is this file which is read 
by the data collection task COL to initialize the measurement 
parameters . 

In addition to the files mentioned above, SMPGEN also will 
output, if requested, a saved answer file (default f i 1 espec is 
TRACE.CMD). This file can be input to another run of SMPGEN 
and will initialize the symbo 1 table to the values of the 
variables saved in the file. 

SMPGEN is driven from a menu of parameter categories. To 
display the menu , type an <ESC> . The menu appears as : 



LEGAL PARAMETER CATEGORIES ARE : 

HOOK TASK MODE LABEL 

BUFFER DEVICE SYSTEM DONE 
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The parameter categories can be specified in any order. If a 
parameter category is not specified , the parameters wi 1 1 
receive default va 1 ues from either : 

o The saved answer file, if one is specified. 

o The table of default parameters . 



Table of Default Parame t ers 

HOOKS - all hooks enabled , excepting Load Over 1 ay , 
Call Directive Processor , and User 
Info rmat ion. 

BUFFERS - DYNAMIC region named TRC PAR created in 
partition GEN, 2 buffers with 8 blocks per 
buffer. 

TASKS - Al 1 tasks enabled for data collection. 
DEVICES - Al 1 devices enabled for data collection. 
MODE - MANUAL mode . 

SYSTEM - System Met r i c s enabled with 60 second 
s amp 1 i n g i nterval . 



LABEL 



- No label . 



To select a parameter category , enter the name of the parameter 
catego ry d e s i red as shown in the f o 1 lowing example: 

ENTER PARAMETER CATEGORY? HOOK 



Once a parameter category is selected , the detailed parameters 
are specified. Each parameter category has a menu of responses 
which are possible for that pa ramete r category . To get the 
menu, type <ESC>. When you are finished entering parameters, 
type "DONE" . 
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A detailed description of each parameter category follows. 

o Label Field 

To select the label parameter category, type: LABEL 

The following query will be displayed: 

ENTER MPB LABEL? 

The response may be any string from to 63 characters 
long. This user-definable string is stored in the MPB 
and will typically contain notes and comments appli- 
cable to a particular measurement run. 1 1 is printed 
as part of the heading on each page of the performance 
report . 

o Hooks 

To select the hooks parameter category, type : HOOK 

The hooks determine whi ch resource usage events are 
recorded to the 1 o g f i 1 e . 

You do not select each hook individually. Rather, you 
select one or more groups of hooks . Each group of 
hooks contains the subset of hooks which will generate 
a consistent set of data for measuring the usage of a 
particular resource . Hooks may be chosen from the 
following groups: 

-- CPU USAGE HOOKS 

This hook group measures task CPU usage. 

It is required for al 1 metri cs for task CPU usage . 

- MEMORY USAGE HOOKS 

This hook group measures task memory usage. 

It is required for all metrics for task memory 
usage and % resident time. 

- I/O DEVICE USAGE HOOKS 

This hook group measures task usage of I/O devi ces 
and the file system. The file system is regarded 
as any ACP which manages a device. Examples are 
F11ACP and MTAACP. 
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This hook group is required for all metrics 
relative to task usage of I/O devices or the file 
system . 

LOAD OVERLAY HOOK 

This hook records the relative block number of a 
task's overlay to the logfile. 

CALL DIRECTIVE PROCESSOR HOOK 

This hook records the directive I D of a directive 
to the logfile. 

USER INFORMATION HOOK 

This hook is i n voked when a task issues a Q 1 to 
the QP : pseudo device. The I / Function Code , LUN , 
and six parameters P 1 - P 6 are written to the 
logfile. 
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Buffers 

To select the buffers parameter category, type : 
BUFFER. 

The hook buffers may be resident in either a static 
common or a dynamic region. The buffer type is 
specified by : 

ENTER BUFFER TYPE? 

The response may be either STAT IC i ndi cati ng a stati c 
common or DYNAMIC indicating a dynamic region. 

NOTE : If "STATIC" is selected, the COL task must have 
been 1 inked to a static common in the instal- 
lation phase (see Chapter 3 , section 3.1.3). 

If "DYNAMIC " is selected , COL must not be linked 
to the static common . 



I f the buffer type is DYNAMIC, the name of the 
system -control led partition in which to create the 
dynamic region is specified by : 

ENTER NAME OF BUFFER MAIN (SYS) PARTITION? 

The name of the buffer common/ regi on is speci f i ed by : 

ENTER NAME OF BUFFER C OMMON/ R EG I N? 

The partition will be divided up into a number of hook 
buffers , determined by: 

ENTER NUMBER OF BUFFERS [2. :8. :2.]? 
Note that from 2 to 8 buffers may be specified. 
Finally, the length of each buffer is specified by: 

ENTER BUFFER SIZE IN 512 B BLOCKS? 

A buffer can be from 1 to 1 6 blocks long; in other 
words, from 256 words to 4096 words long. 

If a static common is used for buffering, the total 
space required for buffers must fit into the common . 
I f a dynami c region is used , COL will create a region 
large enough to contain the buffers. 
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Tasks 

SPM-11M can be set up to collect data for specific 
tasks. For example, there may be some tasks whose 
performance met ri cs are not desired at all. 
Typical I y , system "service" tasks , such as F 1 1 AC P , 
. ..MCR and QMG . . . fall into this category . 

To sel ect the task parameter category , type : TASK . 

The following que ry will appear : 

DO YOU WANT TO TRACE ALL TASKS? 

I f your answer is N, you will be given two choices for 
selecting the tasks for data collection : 

Specify the tasks not to trace. 

Spec i f y the tasks to trace. 
The choice is made from the query : 

DO YOU WANT TO SPEC IFY THE TASKS NOT TO TRACE? 
I f the answer is Y , you are p rompted with : 

ENTER NAME OF TASK NOT TO TRACE? 
If the answer is N, you are p rompted with : 

ENTER NAME OF TASK TO TRACE? 

You then type , one per line, the names of the tasks 
d e s i red or not desired. Each tas kname is from 1 to 6 
characters long. To terminate the list of tasks , type 
<CR> . 

Up to 64 tas knames can be specified. 
Devices 

To get the devices parameter category , type : DEVICE . 
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SPM-11M can be set up to collect data for specific 
classes of devices. I f you want to collect data only 
for selected classes of devices, answer N to the 
following query : 

DO YOU WANT TO COLLECT DATA FOR ALL DEVICES? 

A device in RSX-11M may fall into one of four classes 
depending on the bit setting of the "Device Character- 
istics Word" U.CW1 in the UCB. 



Directory Device (DV.DIR) 

- Sequential Device (DV.SQD) 

- Terminal Device (DV.TTY) 
Al 1 Other Devi ces 



To enable data collection for a device class, answer Y 
to the query for that device class. The queri es are: 

TRACE DISK (DIRECTORY DEVICE) I/O ACTIVITY? 

TRACE TAPE (SEQUENTIAL DEVICE) I/O ACTIVITY? 

TRACE TERMINAL I/O ACTIVITY? 

TRACE ALL OTHER DEVICES I/O ACTIVITY? 



Mode 



To select the mode parameter category, type: MODE. 

The performance monitor can be set up to collect data 
in three different modes. You select the mode by 
answeri n g : 



ENTER MODE? 



The possible modes are: MANUAL, AUTOSTOP and REPEAT. 
Each mode determi nes the manner in which a measurement 
interval begins and ends. A description of each mode 
follows : 



Manual 



In manual mode, a measurement interval begins when 
the COL task is invoked and ends when the TRM 
(termination) task is run. 
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Autos top 

I n autostop mode, a measurement interval begins 
when the COL task is invoked and ends when either 
o f the following two events occur : 

A mark-time expires, 

A predetermined number of buffers have been 
filled. 

You d e t e r m i n e the type of autostop by respondi ng 
t o : 

ENTER SAMPLING TYPE? 
with either TIME or BUFFER . 

I f TIME is specified, you then have to specify the 
timeout interval : 

ENTER SAMPLING INTERVAL TIME UNIT [ D :M I N] 

ENTER SAMPLING INTERVAL IN units ? 

where "units" is the time unit specified in the 
previ ous query . Legal units a re SEC, MI N or HR. 

NOTE : Do not confuse this sampling interval with 
the system metrics sampling interval 
described in the next section. 



If BUFFER is specified a s the interval type , you 
must specify the number of buffers per sample: 

ENTER NUMBER OF BUFFERS PER SAMPLE? 

Note that each buffer is from 1 to 16 disk blocks 
(256 words) long. 

Repeat 

Repeat mode is autostop mode repeated a number of 
times. The sampling interval is specified as for 
autostop mode. I n addition , you must s pec i fy : 

The number of intervals 

The length of time between intervals. 
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You specify these parameters by answering the 
following queries: 

ENTER MAX . NUMBER OF SAMPLES? 

ENTER INTERVAL BETWEEN SAMPLES TIME UNIT [ D :M I N ] ? 

ENTER INTERVAL BETWEEN SAMPLES IN units ? 

where "units" is the time unit specified in the 
previous query. 



Sys tem 

To select the system-metrics parameter group, type 
"SYSTEM" . H y¥ 

If you want the system metrics , answer Y to the next 
query : 

DO YOU WANT THE SYSTEM METRICS? [Y/N] : 

If you answered Y , you must then speci fy the sampling 
i nte r va 1 by : 

ENTER SYSTEM METRICS SAMPLING INTERVAL (SEC) ? 

Done 

When you are finished entering parameters, type 
"DONE". The SMPGEN procedure will then create : 

A monitor parameter block (MPB) file 
( f i 1 ename .MPB ) . 

- A parameter source file ( fi 1 ename . PAR ) . 

- A saved answer file (filename.CMD, if specified). 

Note: SMPGEN will prompt you for the parameter source 
file and saved answer file, and you must enter 
a valid file specification. 
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3.2.2 Us i ng COL 



The COL task is used to initialize the performance monitor, 
start data col lection , collect data, stop data col lection and 
clean up the performance monitor before exiting. 



Installing COL 

The COL task can be i nstal 1 ed in any partition. I f possible , 
create a separate 4K wo rd partition for COL. If i nstal led in a 
system -controlled partition, COL will automatically fix itself 
and mark itself as non-shuf f 1 abl e . 1 1 is therefore d e s i r a b 1 e 
t o install and run COL when there is little or no system 
activity in the partition in which COL is installed so as to 
load COL in the lower end of the partition and reduce fragmen- 
tation of the partition. The COL task will occupy approxi- 
mately 4K words of memo ry . 

COL is taskbuilt with a default priority of 230. Note that COL 
has a higher priority than F11ACP and . . . MC R , but a lower pri- 
ority than . . . LDR . It is highly recommended that the priority 
of COL not be altered to a value lower than the default value 
of 230, otherwise excessive overflows may occur which w i 1 1 
i n v a I i d a t e the measurement runs. 

I f full ASC I I message text output is desired, install the 
COLMSG task. 

I f you are using a static common for COL buffers , be sure to 
install it before installing the COL task. 

Instal i COL and COLMSG by : 

> I NS TRC PAR ; ONL Y FOR STATIC COMMON 

> I N S COL 

> I N S COLMSG 



Running COL 

To run COL, type a command line of the form: 

>C0L 1 ogf i 1 e/sw=MPBf i 1 e/sw 

The default logfile specification is SY :[cur u i c]TR AC E . LOG . 
The default MPBfile specification is S Y :[cu r u i c ]TR AC E . MPB . 
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Stoppi ng COL 

There are two ways to terminate COL: 
o RUN TRM 

o Specify AUTOSTOP or REPEAT mode in SMPGEN. 

RUN TRM will terminate COL regardless of the mode in which COL 
is running: MANUAL, AUTOSTOP or REPEAT. 

COL will also terminate if any of the following abnormal 
conditions are detected: 

o Powerfail recovery 

In this case, if powerfail recovery support is 

included in the executive , COL will issue a SPRA$ 

di recti ve. Upon powerf ai 1 recovery , COL will simply 
exit. 

o Write errors 

If COL detects write errors , it will print a message 
and exit. Write errors will generally corrupt the 
logfile with invalid data. 

o Automatic 11.5-hour termination. 
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COL Switches 



Switch defaults 

Output : SY .-TRACE. LOG/DENS :800/EX : 100. /IF :1 00 . / W I :10. 
Input: SY : TRACE. MPB/DL :0/DV :LBO/PR :GEN 



Output Switches 


Description 


/AP 


Append records to end of magtape. COL will 
space overall existing files on the magtape 
and append the records for this run starting 
at the current end-of -vol ume point. 


/DENS :dens i ty 


Set tape dens i ty to 800 or 1600 bpi, 
Densities cannot be mixed on a single tape 
volume. 


/LA .11 


o p e c i r i e b u i s k t i \ e extent size in £ b b w 
blocks. 


/TC . n 

/ 1 1 . n 


opeciTies disk rile initial size in 2 5 6 W 
blocks. 


/WI :n 


Specifies number of retrieval pointers in 
wi ndow block. 


Input Switches 




/B F :m :n 


Number of buffers = m ; size of buffer = n 
256W blocks. This switch overrides the 
buffering specification in the MPB. 


/DL :n 


Number of MINUTES COL delays before it 
starts data collection. 


,/DV ,-ddnn 


Device selected for system metrics . 


/PR rparnam 


Partition selected for system metrics. 


/TI :nn 


Collect data only for tasks with T I of TTnn. 
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Example 1 

>COL DB2 :[3 , 3 00 ]C PU TE ST/ I F :1000/EX :200 = DB1 :[ 5 ,200]PARM1/DV :DB2 : 

logfile is DB2 :[ 3 ,300 ]C PUTEST . LOG with initial size 1000 and 

extent size 200. 

MPB file is DB1 :[ 5 ,200]PARM1 . MPB with system metrics specified 
for DB2. 



Examp 1 e 2 

>C0L MM1 :/DENS :16 00 = DB1 :[ 5 ,2 00] SAMP L E . MPB 

logfile is on MM 1 : in 1600 BPI; MPB file is 
DB1 :[5 ,200]SAMPLE.MPB . 



Examp 1 e 3 
>C0L = 

logfile is SY .-[current uicjTRACE.LOG; MPB file is S Y .-[current 
uic]TRACE.MPB . 



NOTE : You cannot run COL with a 
<CR>. The COL task expects to 
bare "=" indicating defaults on 
over, you cannot invoke COL with 

>RUN COL 



null command line, i.e, >C0L 
see explicit filespecs or a 

both input and output. More- 

a command of the form : 



since no filespecs can be specified with this form. One final 
thought in this regard: only one copy of COL can be active in 
the system at a time. If multiple invocations of COL are 
attempted at different terminals, all but the first will be 
rejected with an error message "MONITORING ACTIVITY IN 
PROGRESS" . 

Once COL is activated, it will run in the mode specified in the 
MPB but always for a maximum of 11.5 hours. This time limit is 
imposed because the KW11-P clock time will overflow in a little 
over 11.5 hours. 
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COL Messages 



COL outputs two types of messages: error messages and status 
messages . 

Full ASC I I error message text will be printed only if the 
COLMSG task is installed. If the COLMSG task is not installed , 
COL will print a message of the form "COL ERROR XXXXXX 1 ' , where 
XXXXXX is the error number. The error messages are listed by 
error number in the following list. Error messages are issued 
if a n error condition occurs while COL is starting up and 
initializing the performance monitor. Error messages are 
output t o the terminal of issue ( T I : ) for COL. 

Status messages are issued while COL is running in steady 
state. There are status messages for both normal and error 
conditions. Status messages are issued to the console terminal 
(CO:). The COLMSG task does not have to be installed to get 
the status messages; as they are printed di rectly by the COL 
task. 



COL Error Messages 

000000 COLMSG XXXXXX (DSW) GET COMMAND LINE ERROR 

Explanation : A "Get MCR Command Line" di rect i ve failure 
occurred . 

User Act i on : Reenter COL command line using correct 
form. 

NOTE : II legal command forms are: 

1. >C0L <CR> 

2. >RUN $C0L <CR> 

Legal command line forms are: 

1 . >C0L filespec/sw = filespec/sw 

2. >C0L filespec/sw = /s w 

3 . >C0L = f i 1 e s p e c / s w 

4. >C0L = 
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000001 C OLMSG -- COMMAND SYNTAX ERROR 

Explanation: Entered i ncorrect syntax for command line. 
User Action : Reenter comma nd line with correct syntax . 

000002 C0LMSG -- MPB FILENAME SYNTAX ERROR 

Explanation: Entered incorrect syntax for MPB filename. 
User Action: Reenter MPB filename using correct syntax. 

000003 COLMSG -- XXXXXX (FCS) MPB FILE ACCESS FAILURE 

Explanation : COL failed to open MPB file or received a 
read error when a ttempt i n g to read the MPB file. The 
code XXXXXX (FCS) indicates the FCS error code returned 
to COL . 

User Acti on : Check that specified MPB file exists , the 
volume is mounted (if disk) , or that the file protection 
does not prevent COL from readi ng the MPB. 

000004 COLMSG -- XXXXXX (DSW) ASS IGN LUN FAILURE 

Explanation : COL failed to assign a LUN to the logfile 
device. 

User Action : Check that the device specified for 
logfile is in the system configuration. 

000005 COLMSG -- ILLEGAL LOGFILE DEVICE TYPE 

Explanation : The device specified for the logfile is 
not of the correct type. Valid logfile device types 
are : Di rectory structured (disk , DECTAPE ) , or Sequenti al 
(magtape) . 

User Act i on : Spec i f y a device which is either di rectory 
structured or sequenti a 1 . 

000006 COLMSG -- LOG FILENAME SYNTAX ERROR 

Expl anati on : Entered incorrect syntax for logfile. 

User Action: Reenter logfile specification using 
correct syntax . 

000007 COLMSG -- XXXXXX (FCS) LOGFILE ACCESS FAILURE 

Explanation : COL failed to open the logfile. The code 
XXXXXX (FCS) is the FCS error returned to COL. 
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User Act i on : Check that the logfile vol ume is mounted 
and the necessary directory exists (if disk) , or the 
volume is online (if magtape). 



000010 COLMSG -- ILLEGAL BUFFER SPECIFIED 

Explanation : The pa rameters specified by the / B F :n :m 
switch were not valid. Either the number of buffers ( n ) 
was out of range (<2 or >8) or the buffer size was out 

f range ( > 1 6 ) . 

User Act i on : Respecify a v a 1 id buffer count or size via 
the /BF swi tch . 

000011 COLMSG -- XXXXXX (DSW) BUFFER PARTITION NOT IN SYSTEM 

Expl anati on : The partition specified in the MPB is not 
in the system. 

User Action : I f the buffer partition is a static 
common, check that the static common partition exists 
and that the common is installed. 

000012 COLMSG -- BUFFERS WILL NOT FIT INTO PARTITION 

Explanation : The number of buffer blocks specified in 
the MPB (NUMBER OF BUFFERS * BUFFER SIZE IN 5 1 2 B 
BLOCKS) is greater than the number of 512 B blocks in 
the phys i cal buffer partition. 

User Action: Use /BF :m :n or do a SMPGEN and s pec i f y the 
NUMBER OF BUFFERS and BUFFER SIZE I N 512 B BLOCKS such 
that the product of the two is less than or equal to the 
number of 512 B blocks in the phys i cal buffer partition. 

000013 COLMSG -- XXXXXX (DSW) CANNOT CREATE BUFFER PARTITION OR 
ADDRESS WINDOW 

Explanation: COL recei ved a DSW error when attempting 
to create the dynami c buffer partition speci f i ed in the 
MPB, o r when a ttempt i ng to create a n address window to 
map the dy n ami c partition . The error XXXXXX (DSW) is 
the DSW error from the Create Region directive or from 
the Create Add res s Window di recti ve . 

User Action : Check that enough space exists in the GEN 
partition to c o n t a i n a dynami c region with the size 
speci tied in the MPB . 

1 f the error was from a Create Add res s Window directive, 
check the size of the COL task (look a t the map in 
L 1 1 ,2]C0L.MAP) and veri fy that it is less than or equal 
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to 4096 words. If COL is greater than 4096 words, it 
may have been taskbui 1 t using a SYSLIB.OLB with ANSI or 
big buffering FCS routines. COL must then be 

re-taskbui 1 t using a baseline SYSLIB.OLB which contains 
the n o n - A N S I FCS routines. 

000014 COLMSG -- MONITORING ACTIVITY IN PROGRESS 

Explanation : A mul ti pi e invocation of the COL task was 
attempted . Only one copy of COL can be active at a 
time. 

User Act i on : Do not attempt to run more than one copy 
o f COL a t a time. 

000015 COLMSG -- INVALID MPB FILE 

Explanation: The MPB filespec specified in the COL 
command line is not the name of a valid MPB file. 

User Action : Reenter a filespec for a valid MPB file. 

000016 COLMSG -- INFORMATION RECORD ALLOCATION FAILURE 

Explanation: Insufficient space exists in the buffer 
partition to conta i n all the Information Records . 

User Action: Do a SMPGEN and specify enough blocks 
(NUMBER OF BUFFERS * BUFFER SIZE IN 512 B BLOCKS) to 
contain a 1 1 the Inf ormati on Records . The space required 
is roughly that needed to contain the 1 a rgest of the 
following three system lists: l)TCBs, 2) PCBs , and 
3)DCBs-UCBs . 

000017 COLMSG KW11-P VECTOR OR CSR UNAVAILABLE 

Explanation : Either the KW11-P vector is in use , or the 
KW11-P CSR is non-existent on the UNIBUS . 

User Action: Check that the correct KW11-P vector and 
CSR were specified in the procedure @PM0NBLD .CMD , that 
the vector is not used by another R S X - 1 1 M driver or 
task, and that the CSR is addressable on the UNIBUS. 

000020 COLMSG -- CANNOT USE SYSTEM' S KW11-P as SPM-11M CLOCK 

Explanation: The RSX-11M system clock is a KW11-P and 
an attempt was made to use it as the SPM-11M 
(performance monitor) clock. 

User Act i on : Check that a separate KW11-P was installed 
for use by the SPM-11M software , and that the vector and 
CSR specified in the procedure @PMONBLD.CMD was for this 
clock. 
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000021 COLMSG -- POOL NODE ALLOCATION FAILURE 

Explanation: COL could not allocate a RSX-11M pool 
node . 

User Action : Re-run COL when sufficient pool is 
avai 1 ab 1 e . 

000022 COLMSG -- BUFFER OVERFLOW 

Expl anati on : COL failed to allocate space for a hook 
record because all buffers were full. 

User Action : R e - r u n COL, using a larger buffer size 
specified either via SMPGEN.CMD or the /BF switch. 

000023 COLMSG -- PARTITION SPECIFIED NOT IN SYSTEM 

Explanation : The partition specified via the /PR switch 
is not configured in the system. 

User Action: Respecify a partition configured in the 
system. 

000024 COLMSG -- ILLEGAL DELAY VALUE SPEC IF IED 

Explanation : An illegal delay value has been specified 
v i a the / DL switch. 

User Action : Re-specify a delay value in the correct 
range (0 to 1440) . 

000025 COLMSG -- COL NOT TASKBUILT FOR REGION TYPE SPECIFIED IN 
MPB 

Explanation: The COL task was t a s k b u i 1 t to use a 
certain region type (DYNAMIC or STATIC) , but the other 
type ( STATIC or DYNAMIC ) was speci f i ed in the MPB . 

User Acti on : I f you t a s k b u i 1 t COL to use DYNAMIC 
regions, specify only DYNAMIC regions when creating a 
parameter file with SMPGEN; if you tas kbu i 1 1 COL to use 
STATIC regions , speci fy only STAT IC regions when 
creating a parameter file with SMPGEN. 
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COL Status Messages 



COL -- PERFORMANCE MONITOR INITIALIZED 

Explanation: COL has successfully initialized and is 
now ready to collect data. 

User Action: None 

COL -- PERFORMANCE MONITOR EXITING 

Explanation: COL has stopped data collection and has 
cleaned up its databases . This status message is issued 
by COL immediately prior to exiting. 

User Action : None 

COL -- CANNOT MAP OUTPUT BUFFER 

Explanation: COL received a n error when attempting to 
map t o the output buffer using the Map directive. 

User Action : Check that the dynami c region used a s the 
output buffer was successfully created. 

COL -- LOGF ILE WRITE ERROR 

Explanation: COL received an FCS or Q 1 error when 
attempt i n g to write to the 1 o g f i 1 e . 

User Act i on : Check the i ntegri ty of the 1 o g f i 1 e . I f 
repeated errors occur to the same 1 ogf i 1 e , rerun COL to 
create a new disk file or mount a fresh tape. 

COL -- LOGF I LE CLOSE ERROR 

Explanation : COL received an error when attempting to 
close the 1 ogf i 1 e . COL will exit shortly after printing 
this message with the logfile improperly closed. 



User Action: Because the logfile was improperly closed, 
it may be difficult to read the logfile and produce a 
performance report. 
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COL -- BUFFER OVERFLOW 

Explanation: Hook records were written to the hook 
buffer faster than COL could write them to the logfile. 

User Action : I n general, the data collected during a 
measurement interval which overflowed is not usable by 
the MDR task to produce a performance report . An 
attempt should be made to rerun the measurement to 
obtain data without overflow. Prior to attempt i ng 
another measurement run , a SMPGEN should be run with 
larger buffers specified than for the measurement run 
whi ch overf 1 owed . 



3.2.3 Using TRM 

The TRM task is used to manual 1 y signal the COL task to stop 
data collection, cleanup and exit. TRM will cause COL to exit , 
regard 1 ess of the mode in which COL was running : manual , 
autostop o r repeat . 

TRM is run by the command >RUN TRM . 
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3.2.4 Using MDR 

MDR is used to read the logfile and produce a performance 
report. MDR is used in conjunction with DRS (sorting) task to 
produce the performance report. The general procedure is as 
follows : 

o > I NS DRS 
>RUN MDR 

MDR>LISTFILE/sw=LOGFILE/sw 

MDR wi 1 1 read the command line and execute pass 1 . 
MDR wi 1 1 then attempt to spawn the task DRS. I f MDR 
detects a n error in the spawn , or MDR has been built 
t o prevent automatic spawn , the DRS pass must be 
executed manually. I n this case , MDR will print the 
following message and suspend: 

MDR -- YOU MUST NOW SORT THE INTERMEDIATE FILE BY 
USING DRS.TSK 

MDR -- 

>DRS RESOURCE .SRT= RE SOURCE .TMP/FO :V : 1 5 6 / K E :1 . 12/ PR :T 

MDR -- AFTER THE SORT HAS COMPLETED , RESUME THIS TASK 
( ... MDR ) 

NOTE : Rather than type the command line to DRS as shown 
above, you can simply invoke the command file @DRS . 



o >§DRS sorts the intermediate file, 
o >RES MDR 

MDR executes pass 2 and prints the performance report, 
o MD R> AZ 



Certain MDR command switches restrict the input data which will 
be processed . I f a logfile contains too much activity for MDR 
to reduce the data without runni ng out of space , these switches 
(/AF, /BF, /-MD, /NT, /NU, /TS , /UC) may be used to reduce a 
logfile by successive runs of MDR , analyzing only parts of the 
workload in each run. 

When using the switches / NT , / NU , /TS, or /UC , MDR wi 1 1 p rompt 
for the task or device names after the command line is 
processed. The tasknames are specified as 1 to 6 RAD50 
characters per ent ry . On 1 y generic tasknames are used for /NT 
or /TS. The TI device names are entered as " D D n n : " , with one 
entry per line. 
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MDR Switches 

Switch defaults -- 

output : SY .-REDUCE. RPT/SP 

input : SY :TR AC E . LOG/DM :2/L I :2/RW/SI :613/MD/SK :0/DE :800/- IC/-SC 



Output Switches 



Description 



/SP /-SP 



SPool output file 



Input Swi tches 



/AF 
/BF 
/DE :nnnn 
/DM :nnn 



PChi gh :PC1 ow 
PC hi gh : PC 1 ow 



/IC 
/LI 



/-IC 



:n n 



Only process records from AFter specified 
time 

Only process records from BeFore specified 
time 

Select input magtape DEnsity, 800 or 1600 
(ignored unless / RW is also used) 

DuMp specified record types , nnn is total 
of desired types: 

001 - buffer headers 

002 - unknown record types 

004 - system configuration info records 

010 - task event hook records 

020 - system metric records 

040 - user information hook records 

100 - load overlay hook records 

200 - call directive processor hook records 

Replace the % resource column of the report 
with a count of incomplete intervals. 

Detail level of task workload metrics: 

00 - no report produced 

01 - system-wide summary only 

02 - system and task summaries 

03 - system, task, and TI: summaries 

04 - all summaries and each complete 

task run 

05 - all summaries and all task invocations 
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MDR Switches (continued) 



Input 


Switches 


Description 


/MD 


/- 


MD 


Report on tasks with missing data 


/NT * 






Do Not process hooks for listed Tasks 


/NU * 






Do Not process hooks for listed devices as 
TI : 


/SC 


/- 


SC 


Produce System Configuration section of 
report 


/SI :nn 






Selects the contents of Sampling Interval 
report by setting nn to the total for the 
desired i terns : 

000 - no report produced 

001 - data collection start/stop times 

002 - % CPU usage 

004 - % memory partition usage 

010 - % device time busy 

020 - % device space used 

040 - % POOL used 

100 - % CKPT space used 

200 - clock time of metrics 

400 - trailing blank line after the metrics 


/SK :nnn 




SKip nnn files when opening tape input file 


/RW 


/- 


RW 


ReWind tape input file before opening 


/IS * 






Process hook records only for listed TaSks 


/UC * 






Process hook records only for listed 
devices as TI: 



* - the switches /Nl and / \S are mutually exclusive. 
- the switches /NU and /UC are mutually exclusive. 
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MDR Messages 

The MDR messages are issued to the TI device under which MDR 
runs. This section discusses the messages which MDR can issue. 

MDR -- PLEASE ENTER TASKNAMES ONE AT A TIME FOLLOWING EACH 
» MDR -- WITH A <CR> . TYPE JUST A <CR> AFTER THE LAST ONE IS 

ENTERED 
MDR -- TSKNAM> 

*t Expl anat i on : This is the prompt for the generic task- 

names for filtering by the /NT or /TS switch. The last 
line of this message is repeated for each line of input. 

User Action: Enter generic task name(s). 



MDR -- PLEASE ENTER TI DEVICES (DDNN :) ONE AT A TIME FOLLOWING 
EACH 

MDR -- WITH A <CR> . TYPE JUST A <CR> AFTER THE LAST ONE IS 

ENTERED 
MDR TI DEVICE> 

Explanation: This is the prompt for device names to be 
used by the /UC or /NU filter. The last line of this 
message is repeated for each line of input. 

User Act i on : Ente r full device name (s ) as "DDnn :" . 



MDR -- YOU MUST NOW SORT THE INTERMEDIATE FILE BY USING DRS.TSK 
MDR -- (E.G.) MC R > DR S 

RESOURCE .SRT = RE SOURCE .TMP/FO :V : 156/ KE :1 . 12/ PR :7 
MDR -- AFTER THE SORT HAS COMPLETED , RESUME THIS TASK (TSKNAM) 

Explanation : This mess age indicates that the first pass 
of MDR has completed. Manual intervention is now 
required to run the DRS task with the given command. 
The task name under which MDR is running is given in 
parentheses in the last line of the message. 

User Act i on : Run the DRS task (@DRS.CMD) , and when it 
has completed, resume the MDR task. 



MDR -- DSW :###### F. ERR :###### IOSB :###### ###### PC :###### 
S P 

MDR -- STK :###### ###### . . . 

Explanation: This is a status message which gives 
detail of the internal state of MDR at the time when an 
error is detected. This message is always followed by 
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one of the messages discussed below, which describes the 
actual error condition. 

User Action: See action specified for the message 
issued immediately following this status message. 

* 

MDR AN INCOMPLETE RESOURCE UTILIZATION REPORT WILL BE 
PRODUCED 

Explanation: An error occurred which prevented the 
completion of pass II of MDR. Although a report will be 
produced, not all task-workload data has been summa- 
rized. A previous error message is issued giving the 
cause of this condition. 

User Action: As specified for previous message. 

( 

MDR -- ATTEMPT TO PRINT NULL TWB 

Explanation: An internal inconsistency occurred in the 
pass II processing of MDR. 

User Action : * * * SPR ! 

MDR ATTEMPTING TO DEALLOCATE TWB NOT IN TSKHD 

s 

Explanation: An internal inconsistency occurred in the 
pass I processing of MDR. 

User Acti on : * * * SPR ! 



MDR -- CHECKPOINT USAGE > 100% 

Explanation: A Checkpoint metric indicates more than 
100% usage of the checkpoint space. The metric is not 
reported. 

User Action: Ensure logfile is not corrupted. 



MDR -- CLOCK STOPPED OR HOOK RECORD OUT OF TIME SEQUENCE. 

Explanation: The records in the logfile do not follow a 
strict time sequence. This condition invalidates the 
data in the logfile. 

User Action: Ensure that the KW11-P clock is 

functioning. Re-collect the data. 
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MDR -- COMMAND READ ERROR 

Explanation: An I/O error occurred while attempting to 

read the MDR command line. 

User Action: Reenter the MDR command. 

* 

MDR -- COMMAND SYNTAX ERROR 

n Explanation: The command as entered "has improper 
syntax . 

User Action: Reenter the corrected MDR command. 



MDR COMPLETION ERROR IN INPUT READ 

Explanation: An I/O error occurred while reading the 
logfile. This condition will be treated as end-of-file 
and MDR will attempt to continue. This may be 
symptomat i c of a corrupted logfile. 

User Act i on : Check IOSB for error cause. Rerun MDR 
using another logfile if necessary. 



MDR -- CONFLICTING SWITCHES /TS+/NT OR /UC+/NU 

Explanation : The switches / T S and /NT were both speci- 
fied , or the s wi tches / UC and / NU we re both specified. 
On 1 y one of each pair of switches may be specified. 

User Acti on : Reenter the command line without both of 
the conf 1 i cti ng switches. 



MDR -- DEVICE USAGE > 100% 



Explanation: MDR processed a 
indicates greater than 100 
zation. No graphic output 
suspect record . 

User Acti on : * * * SPR ! 



MDR -- DEVICE'S AC P NOT FOUND 



system metric record which 
percent of device utili- 
will be produced for the 



Explanation: The system information records indicated 
that a device was mounted, yet no TCB for the AC P task 
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was found. The device may have been dismounted concur- 
rently with COL's scan of the system configuration. A 
generic AC P name will be used for the device's ACP 
f uncti ons . 



User Action 



None 



MDR -- DYNAMIC SPACE ALLOCATION FAILURE 



Explanation: MDR 
itself to provide 
This indicates a severe 
space . 



was unable to sufficiently extend 
space for initialization of pass I. 

shortage of necessary dynamic 



User Action: Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend. Use SET /MAXEXT to allow sufficient extension. 
Use of smaller buffers by COL will lower the MDR space 
requirement. Use overlaid version of MDR. 

MDR -- ERROR ATTACHING, POSITIONING OR SELECTING DENSITY OF 
MAGTAPE 



Expl anati on : An 
open the logfile 
mounted to MTAACP 



I/O error occurred when attempting to 
on magtape. The drive may have been 
which is incorrect since MDR does Q I Os 



directly to the tape device driver. 
User Action: Correct the condition and rerun MDR. 

MDR -- ERROR CLOSING INPUT FILE 

Explanation: An I/O error occurred when closing the 
input logfile. 

User Acti on : None . 



MDR -- ERROR CLOSING REPORT FILE 



Expl anati on 
report file 
spooled, or 
the task PRT. 



An I/O error 
Thi s file will 



MDR d 1 1 e in p t e d to 



was not 



occurred when closing the 
not be properly closed or 
spool the output file but 
installed. 



User Action: Correct the condition 
the file, or rerun MDR . 



and manually close 
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MDR -- ERROR CLOSING RESOURCE. TMP FILE 

Explanation: An I/O error occurred at the end of pass I 

when closing the RESOURCE. TMP file. The DRS task will 

not be able to read this file until it is properly 
closed. 

User Action: Correct the condition and manually close 

the file, or rerun MDR . 



MDR -- ERROR DELETING RESOURCE. TMP FILE 

Explanation: An I/O error occurred when MDR deleted 
its temporary file. The file is not properly closed, or 
deleted. 

User Action : Manual ly unlock and delete this file. 

MDR -- ERROR IN GTSK$S 

Explanation : The directive failed preventing MDR from' 
obtaining its taskname. The message requesti ng the sort 
t o be run wi 1 1 not include MDR's taskname. 

User Act i on : None . 

MDR -- ERROR IN INPUT READ Q 1 

Explanation: An I/O error occurred while reading the 
logfile. This condition will be treated as end-of-file 
and MDR will attempt to continue. This may be 
symptomatic of a corrupted logfile. 

User Action : Check DSW for error cause. Rerun MDR 
using another logfile if necessary . 



MDR -- ERROR OPENING RESOURCE. SRT FILE 

Explanation: An error was reported by FCS when MDR 
attempted to open the RESOURCE. SRT file for pass II. 
Pass II will not be able to run. 

User Acti on : Correct the condition indicated by F .ERR 
and rerun MDR. 
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MDR -- ERROR OPENING RESOURCE. TMP FILE 

( 

Explanation: An error was reported by FCS when MDR 
attempted to open the RESOURCE. TMP file for write in 
pass I. Pass I will not be able to run. 

User Action: Correct the condition indicated by F.ERR 
and rerun MDR . 



MDR -- ERROR OUTPUTTING PRINT LINE 

Explanation: An error was reported by FCS when MDR 
attempted to output a record to the report file. MDR 
will attempt to continue to produce the report. If this 
error is not caused by a transient condition the message 
will be repeated, and MDR will have to be aborted. 

User Action: Correct the condition and rerun MDR. 



MDR -- ERROR READING MPB 

Explanation: An I/O error occurred when attempting to 
read the first block of the logfile. 

User Action: Correct the condition and rerun MDR. 



MDR -- ERROR READING RESOURCE. SRT FILE 

Explanation: An I/O error occurred in pass II when 
attempting to read from the RESOURCE. SRT file. This 
will be treated as an end-of-file condition. 

User Action: Correct the condition and rerun MDR. 

( 

MDR -- ERROR REOPENING RESOURCE. TMP FILE 

Explanation: An I/O error occurred when attempting to 
re-open the RESOURCE. TMP file so it could be deleted. 
The RESOURCE. TMP file will not be deleted. 

User Action: Delete the file manually. 



MDR -- ERROR SKIPPING OVER MPB BUFFER 

Explanation: An I/O error occurred when repositioning 
the tape logfile so the MPB could be reread once the 
buffer size is known . 
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User Action: Correct the condition and rerun MDR . 



MDR ERROR WRITING RESOURCE. TMP FILE 

Explanation: An I/O error was reported by FCS for a 
write operation during pass I. 

User Action: Correct the condition and rerun MDR. 



MDR -- EXPECTED RIB NOT FOUND 

Explanation: An inconsistency occurred in MDR's 
internal dynamic data structures. 

User Action: See Chapter 7, Section 7.3. 



MDR -- EXPECTED RWB PREDECESSOR NOT FOUND IN OVERLAP 

Explanation: An inconsistency occurred in MDR's 
internal dynamic data structures. 

User Acti on : * * * SPR ! 



MDR -- EXPECTED RWB PREDECESSOR NOT FOUND IN MERGE 

Explanation: An inconsistency occurred in MDR's 
internal dynamic data structures. 

User Acti on : * * * SPR ! 



MDR -- IDLE TIME > 100% 

Expl anation : MDR processed a sys tern met r i c record which 
indicates greater than 100 percent of CPU idle time. No 
graphic output will be produced for the suspect record. 

User Action: See Chapter 7, Section 7.8. 



MDR -- IMPROPER FORMAT OR NO SUCH DEVICE IN SYSTEM. PLEASE 
RETYPE . 

Explanation: An improper response was entered to the 
prompt for TI filter devices. 

User Action: Enter a corrected response. 
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MDR -- INPUT FILESPEC OR SWITCH SYNTAX ERROR 

( 

Explanation: An improper command line was used with 
MDR. 

User Action: Reenter the command. 

f 

MDR -- INVALID DENSITY SELECTED, 800 OR 1600 ONLY 

Explanation: A magtape density other than 800 or 1600 
was speci f i ed . 

User Action: Reenter the command with the correct 
dens i ty . 



MDR -- INVALID DEVICE SPACE METRIC RECORDED 

Explanation: A system metric record indicates more than 
100% of device space used. The device space metric will 
not be reported. This metric is only available for 
devices mounted to F11ACP. 

User Action: Ensure logfile not corrupted. 



MDR -- INVALID INPUT DEVICE TYPE 

Explanation: An attempt was made to reduce a logfile 
which is not on either a disk or tape volume. MDR can 
only use disk or tape for the input file. 

User Action: Do not use MDR to read logfiles not 
residing on disk or tape. 

( 

MDR -- INVALID INPUT FILESPEC 

Explanation: A syntax error occurred in the input 
filespec part of the MDR command. 

User Action: Correct and reenter the command. 

fcfl p D TMWAI Tr\ I TCTTMp i r w r i 

Explanation: An invalid listing level was specified in 
the /LI switch. Acceptable values range from to 5. 

User Action: Correct and reenter the command. 
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MDR -- INVALID MPB FOUND BY ALC 

Explanation: The logfile was found to contain improper 
data. This may be a result of using MDR to read a 
logfile produced by an incompatible COL version. This 
may also be the result of using MDR to read a file which 
was not produced by COL, or was corrupted. 

User Action: Rerun MDR using a valid logfile. 



MDR -- INVALID MPB FOUND BY INF 

Explanation: The MPB did not pass validity testing when 
it was reread once the logfile buffer size was known. 
The logfile may have been corrupted while MDR was 
processing it. 

User Action: * * * SPR ! 



MDR -- INVALID POOL METRIC RECORDED 

Explanation: A Pool metric indicates more than 10 0% DSR 
usage. The metric is not reported. 

User Action: Ensure logfile is not corrupted. Do not 
change DSR size while COL is running. 



MDR -- INVALID RAD50 CHARACTER IN YOUR INPUT. PLEASE RETYPE. 

Explanation: The response to the taskname prompt for 
filtered names was not a valid RSX-11M taskname. All 
letters should be in uppercase. 

User Action: Correct and retype the response. 



MDR -- INVALID TIME VALUES; /AF MUST BE EARLIER THAN /BF 

Explanation: An attempt to use time filter values which 
overlapped causes this message. This condition will not 
allow any records to pass the filter for processing. 

User Action: Correct and reenter the MDR command. 
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MDR -- MEMORY USAGE > 100% 

Explanation: MDR processed 
indicates greater than 100 
zation. No graphic outpu 
suspect record. 

User Acti on : * * * SPR ! 



a system metric record which 
percent of partition utili- 
t will be produced for the 



MDR -- MISSING INFO FOR DEVICE METRIC 

Explanation: The Info record describing the system 
metric device was not found. Device system metrics will 
not be reported. 

User Action: Do not load or unload device drivers while 
COL is active. Ensure logfile is not corrupted. 



MDR -- MISSING I$SYS FOR POOL METRIC 

Explanation: The DSR size was not found in the logfile. 
The Pool system metric is suppressed. 

User Action: Ensure logfile is not corrupted. 

( 

MDR -- MISSING " = " AND INPUT FILESPEC 

Explanation: The input command contains no "=" and no 
input filespec. Both input and output filespecs must be 
supplied or defaulted. 

User Action: Enter a corrected MDR command including 
the "=". 



MDR MORE THAN ONE INPUT FILESPEC NOT ALLOWED 

Explanation: The MDR command contains more than one 
input filespec. 

User Action: Enter a corrected MDR command with only 
one input filespec. 



MDR -- MORE THAN ONE OUTPUT FILESPEC NOT ALLOWED 

Explanation: The MDR command contains more than one 
output filespec. 

( 



1/82 GUIDE TO USING SPM-11M 3-38 



User Act ion: Enter 
one output filespec. 



a corrected MDR command with only 



MDR -- MPB FOUND AT LOCATION OTHER THAN FIRST RECORD OF FILE 

4 Explanation: An MPB was read in the wrong position in 

the logfile. This is indicative of a corrupted logfile. 
MDR will bypass this MPB and attempt to continue to 
process the corrupted logfile. Reports produced from 
this logfile are suspect. 

User Action: Use a different logfile for analysis. 



MDR -- MPB NOT FOUND - NOT TRACE FILE 

Explanation: The MDR input file did not begin with a 
MPB. Either the file was corrupted or it is not a 
logfile. 

User Act i on : Use a different logfile for analysis. 

MDR -- NO FOLLOWING PRIMARY RUB FOUND 

Explanation : An i nternal inconsistency was detected in 
pass I . 

User Act i on : * * * SPR ! 



MDR -- NO FPP OR BUILT /-FP 

Explanation : MDR is unable to initialize for FPP ASTs . 
Either MDR was taskbui 1 1 with the /-FP switch , or the 
processor where MDR is running has no FPP. This message 
cannot occur if the E I S version of MDR is used. 

User Acti on : Rebuild MDR using the di stri buted . C MD 
file. On 1 y run the FPP version of MDR on processors 
with an FP-11. 



MDR -- OUTPUT FILESPEC OR SWITCH SYNTAX ERROR 

Explanation: A syntax error was detected in the output 
filespec or an invalid output switch was specified. 

User Action: Correct and reenter the MDR command. 
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MDR -- OVERFLOW BEFORE MPB - BAD TRACE FILE 

Explanation: The logfile indicates buffer overflow 
occurred before the MPB was written. Either the logfile 
was corrupted, or the file was not produced by COL. 

User Action: Use another file for MDR input. 



MDR 



OVERFLOW IN FIRST PASS SUMMARIZATION 



Explanation: A floating overflow occurred in pass I. 
Incorrect data will be reported for the particular task 
and summaries which this data represents. 



User Act ion: Use . the 
Use filtering to limit 
prevent this condition. 



resulting 
the amount 



report with caution, 
of data processed to 



MDR -- OVERFLOW IN SECOND PASS SUMMARIZATION 

Explanation: A floating overflow occurred in pass II. 
Incorrect data will be reported for the particular task 
and summaries which this data represents. 



User Act ion: Use the 
Use filtering to limit 
prevent this condition. 



resulting 
the amount 



report with caution, 
of data processed to 



MDR -- PARTITION RIB NOT FOUND FOR S$MEM 

Explanation: A system metric record was read for a 
partition which was not described by the system con- 
figuration information records. The graphic output of 
memory utilization will be suppressed. 



User Action 



None 



MDR 



PRINT LINE TOO LONG 



Explanation: MDR generated 
than 132 bytes. The line 
which writes to the file. 



a report file 
is truncated 



record longer 
by the logic 



User Action 



* * SPR i 
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( 



MDR -- RIB LIST LINKAGE ERROR 

Explanation: An inconsistency was detected in MDR's 
internal representation of the system configuration. 

User Act i on : * * * SPR ! 



MDR -- RWB WITHOUT TWB FOUND IN RESOURCE. TMP 

Explanation : A record in the RESOURCE . SRT file was 
encountered in an illogical position. The record is 
d i s ga rded . 

User Acti on : * * * SPR ! 



MDR -- SUMMARIZING FROM NULL TWB 

Explanation : An i neons i stency was detected in the pass 
I I data structu res . 

User Action : * * * SPR ! 



MDR -- SUMMARIZING INTO NULL TWB 

Explanation: An inconsistency was detected in the pass 
1 1 data s tructures . 

User Acti on : * * * SPR ! 



MDR -- SVTK FAILURE 

Expl anati on : The RSX executive rejected MDR's attempt 
t o s pec i f y a n SST vector. 

User Acti on : Correct the condition i ndi cated by the DSW 
and rerun MDR. 



MDR -- SYSTEM + IDLE TIME > 100% 

Explanation : A system met r i c record was read which 
indicates the total of kernel and idle time is greater 
than the elapsed time. The graphic output for the 
record is suppressed. 

User Action: See Chapter 7, Section 7.8. 
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MDR -- SYSTEM TIME > 100% 

f 

Explanation: A system metric record was read which 
indicates more kernel time than elapsed time. The 
graphic output for the record is suppressed. 

User Action: See Chapter 7, Section 7.8. * 



MDR -- TI : READ ERROR 

Explanation: An I/O error occurred when reading filter 
values from the user. 

User Action: Rerun MDR. 



MDR -- TRAP ### 

Explanation: A floating point or conversion error 
occurred. The octal number in this message indicates 
the precise error cause. 

User Acti on : * * * SPR ! 



MDR -- TRUNCATED INPUT FILE RECORD 

Explanation: The end of a buffer was reached before all 

the records in that buffer were processed. This 
indicates a corrupted logfile. 

User Action: Use a different logfile for analysis. 



MDR -- TWB/RWB/R IB DYNAMIC SPACE ALLOCATION FAILURE 

Explanation: MDR was unable to get needed virtual space 
for a dynamic structure in pass I. However sufficent 
dynamic storage was obtained to begin pass I. 

User Acti on : Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend. Use SET /MAXEXT to allow sufficient extension. 
Use of smaller buffers by COL will lower the MDR space 
requirement. Use of filtering of MDR input will also 
lower this space requirement. Use overlaid MDR. 



- 
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MDR -- UNABLE TO ALLOCATE RESOURCE .SRT BUFFER 



Explanation: MDR was unable to get needed virtual space 
for a dynamic structure in pass 1 1 . 

User Action: Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend . Use SET /MAXE XT to allow sufficient extens ion. 
Use o f filtering of MDR input will lower this space 
requirement. Use overlaid MDR . 



MDR -- UNABLE TO ALLOCATE RIB 



Explanation : MDR was unable to sufficiently extend 
i t s e 1 f to provide space for initialization of pass I . 
This indicates a severe shortage of necessary dynamic 
space . 

User Action : Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend . Use SET /MAXE XT to allow sufficient extension. 
Use of smaller buffers by COL will lower the MDR space 
requirement. 



MDR 



UNABLE TO OPEN INPUT FILE 



Expl anati on : An I / error occurred when MDR attempted 
t o open the 1 o g f i 1 e . 



User Action : Correct the condition and rerun MDR . 



MDR -- UNABLE TO OPEN OUTPUT FILE 

Explanation : An I / error occurred when MDR attempted 
to open the report file. 

User Acti on : Correct the condition i ndi cated by F . ERR 
and rerun MDR. 



MDR -- UNKNOWN INFO TYPE RECORD FOUND 

Explanation: A corrupted log file, or a file not 
produced by COL is being used as MDR input. 

User Action: Use a different file for MDR input. 
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MDR -- UNKNOWN RECORD TYPE 

Explanation: A corrupted logfile, or a file not 
produced by COL is being used as MDR input. 

User Action: Use a different file for MDR input. 

MDR -- WILDCARD NOT ALLOWED IN FILESPEC 

Explanation: The MDR command contains a wildcard. 

User Action: Reenter the command without any wildcards. 

MDR -- WRONG FOLLOWING PRIMARY RWB FOUND 

Explanation: An inconsistency was detected in MDR's 
pass I dynamic data. 

User Action: * * * SPR ! 
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3.2.5 Using CLF 



CLF is used to copy logfiles produced by COL. The three modes 
o f CLF operation are: 

o Buffer Transfer Mode, 

which copies a logfile from either disk or tape, to 
disk or tape, maintaining the logfile format which MDR 
uses for input. 

o FCS Record Transfer Mode, 

which copies a logfile from either disk or tape , 
produci ng a n output file with variable length FCS 
records . 

o Read-only Mode , 

which reads the logfile, computes overf 1 ow and buffer 
counts , but does not create a new file. 

The general procedure for using CLF i s : 

>RUN CLF . 

CLF> [OUTFILE/sw =] LOGFILE/sw 

Note that the output filespec and "=" are optional . If these 
are not specified, CLF will operate in read-on 1 y mode , 
producing no output file. 

When FCS mode is speci f i ed ( by the /FCS switch), the records 
have the format speci f i ed in appendices A through D . The first 
word of each record is the record ID which uniquely identifies 
the record type . If overflows occur within the data stream , a 
special "overflow record " is pi aced in the output file at the 
point where records were lost due to overf 1 ow. The format of 
this (length = 4. bytes ) record is: 




600(8) = overflow record ID 



count of records 1 ost by overf 1 ow at 
this point 



When the /FCS switch is used, the default output filespec is 
changed to TRACE. FCS. 

After CLF has comp 1 eted reading the input file, the run 
statistics will be reported to CLF's T I : . 
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CLF Switches 



Switch defaults 

output : SY .-TRACE. L0G/-AP/DE :800/-FCS 
input : SY :TRAC E . LOG/DE :800/RW/SK :0 



Output Switches Description 


/AP /-AP 

/DE :nnnn 

/FCS[ :nn] /-FCS 


APpend file to the end of magtape. CLF 
will space over all existing files on the 
magtape and write the new file starting at 
the current end-of -vol ume point. 

Selects output magtape DEnsity, 800 or 1600 

Selects FCS sequential records in the 
output file, and changes the default output 
f i 1 espec to TRACE. FCS. If ":nn" is not 
specified, all record types will be copied. 
I f " :nn " is specified, only sel ected record 
types wi 1 1 be wri tten . "nn" is the total 
for des i red record types : 

001 - overflow records 

004 - system configuration records 

fl 1 fl +■ a c 1/ £i w a n +■ h n n b r o r c 
UIU - lao K cvcll L IIUUK 1 cLUI Ub 

020 - system metric records 

040 - user information records 

100 - load disk overlay records 

200 - call directive processor records 


Input Switches 




/DE :nnnn 

/RW /-RW 
/SK :nnn 


Selects input magtape DEnsity, 800 or 1600 
(ignored unless /RW is also used) 

ReWind tape input file before opening 

SKip nnn files when opening tape input file 
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CLF Messages 



The CLF messages are i ss ued to the T I device under which CLF is 
run. This section di scusses the messages which CLF can issue. 



CLF -- #### BUFFERS READ 

CLF -- #### RECORDS READ 

CLF -- #### BUFFERS WITH OVERFLOW 

CLF -- #### RECORDS LOST BY OVERFLOW 



Explanation : This stati sties message is output at the 
comp 1 et i on of each run of CLF, indicating the statistics 
about the input file. 



User Act i on : None . 



CLF -- #### FCS RECORDS WRITTEN 



Exp 1 a n a t i o n 
produces an 

User Act i on 



: This statistics 
FCS output file. 

None . 



message is output when CLF 



CLF -- DSW :###### F . ERR :###### IOSB :###### ###### PC :###### 

SP :###### 
CLF -- ST K :###### ###### . . . 

Explanation : This is a status message which gives 
detail of the i nternal state of CLF a t the time when a n 
error is detected. This message is always followed by 
one o f the messages discussed below, which desc ri bes the 
actual error condition. 

User Action : See action specified for the message 
issued immediately after this status message . 



CLF -- COMMAND READ ERROR 

Explanation : An I/O error occurred while reading the 
command line. 

User Action : Reenter the command . 



CLF -- COMMAND SYNTAX ERROR 

Explanation : The command has improper syntax . 
User Action: Reenter the corrected command. 
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COMPLETION ERROR IN INPUT READ 

Explanation: an I/O error occurred while reading the 
input file. This condition, which may be symptomatic of 
a corrupted logfile, will be treated as end-of-file. 

User Action: Check F.ERR and I0SB for error cause or 
u s e a n o t h e r 1 o g f i 1 e . 



ERROR ASSIGNING INPUT DEVICE 

Explanation : CLF was unable to assign a 
input file. 

User Action: Check DSW and F.ERR for cause, 
filespec syntax is correct . 



ERROR ASSIGNING OUTPUT DEVICE 

Explanation : CLF was unable to assign a LUN to the 
output file. 

User Action : Check DSW and F.ERR for cause. Ensure the 
filespec syntax is correct. 



ERROR ATTACHING, POSITIONING OR SELECTING DENSITY OF 
MAGTAPE 



Explanation : An I/O error occurred when at tempt i ng to 
open a file on magtape. 

User Acti on : Ensure the drive is not mounted if logfile 
format is used for that file. Ensure the output drive 
is selectable, and not write locked. Correct the error 
indicated by DSW or IOSB. 



ERROR CLOSING INPUT FILE 

Explanation; An I/O error occurred when closing the 
input file. 

User Acti on : None . 



LUN to the 
Ensure the 
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CLF -- ERROR CLOSING OUTPUT FILE 

Explanation : An I / error occurred when truncating or 
closing the output file. 

User Act i on : Correct the condition and rerun CLF, or 
manually unlock the output file. 



CLF -- ERROR IN INPUT READ QIO 

Explanation : An I / error occurred while reading the 
input file. This condition , which may be symptomatic of 
a corrupted log file, will be treated a s end-of-file. 

User Act i on : Check DSW for cause . Rerun using another 
1 ogf i 1 e if necessary . 

( 



CLF -- ERROR READING MPB 

Explanation: An I / error occurred when reading the 
first block of the 1 ogf i 1 e . 

User Action : Correct the condition and rerun. 



CLF -- ERROR WRITING TO OUTPUT FILE 

Explanation : An I/O error occu r red when writing to the 
output file. 

User Action : Correct the condition and rerun. 



CLF -- INPUT FILESPEC OR SWITCH SYNTAX ERROR 

Explanation : A syntax error was detected in the input 
f i 1 espec . 

User Action : Reenter the corrected command . 



CLF -- INVALID DENSITY SELECTED , 800 OR 1600 ONLY 

Explanation : A magtape dens i ty other than 800 or 1600 
was specified. 

User Act i on : Reenter the command with a correct 
density. 
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CLF -- INVALID INPUT DEVICE TYPE 

Explanation: An attempt was made to read a file not on 
disk or tape . Disk and tape are the only acceptable 
media for log files. 

User Action : Do not use CLF to read files not on disk 
or tape . 



CLF -- INVALID MPB FOUND 

Explanation: The first block of the input file does not 
pass certain validity tests which ensure the file is a 
logfile. This may be caused by a corrupted or obsolete 
logfile, or a logfile produced by an incompatible 
version of COL. 

User Act i on : Use a different logfile. 

CLF -- INVALID OUTPUT DEVICE TYPE 

Explanation: An attempt was made to write in logfile 
format to a device other than disk or tape. 

User Act i on : Only write 1 ogf i 1 e format to disk or tape. 

CLF -- MORE THAN ONE INPUT FILESPEC NOT ALLOWED 

f 

Explanation: The command has improper syntax. 
User Action : Reenter the corrected command . 

CLF -- MORE THAN ONE OUTPUT F ILESPEC NOT ALLOWED 

Explanation : The command has i mp rope r syntax. 
User Action: Reenter the corrected command. 

CLF -- MPB NOT FOUND - NOT TRACE FILE 

Explanation: The first block of the input file does not 
pass certain validity tests which ensure the file is a 
logfile. This may be caused by a corrupted or obsolete 
logfile. 

User Action: Use a different logfile. 
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CLF -- OUTPUT FILESPEC OR SWITCH SYNTAX ERROR 

Explanation: A syntax error was detected in the output 
f i 1 es pec . 

User Action : Reenter the corrected command. 

CLF -- OVERFLOW BEFORE MPB - BAD TRACE FILE 

A Explanation: The first block of the input file does not 

pass certain validity tests which ensure the file is a 
logfile. This may be caused by a corrupted or obsol ete 
1 og f i 1 e . 

User Act i on : Use a different logfile. 

CLF -- TRUNCATED INPUT FILE RECORD 

Explanation: The end of a buffer was reached before all 
records in that buffer were processed . This indicates a 
corrupted logfile. 

User Ac t i on : Use a different logfile. 

CLF -- UNABLE TO OPEN INPUT FILE 

Explanation: An I / error occurred while opening the 
input file. 

User Act i on : Correct the condition and rerun. 

CLF -- UNABLE TO OPEN OUTPUT FILE 

Explanation : An I/O error occurred while opening the 
outpu t file. 

User Action : Correct the condition and rerun. 

CLF -- UNKNOWN RECORD TYPE 

Explanation: An unknown record I D was found in the 
file. 

--. 

User Action : Use a different logfile. 
CLF -- WILDCARD NOT ALLOWED IN FILESPEC 

Expl anati on : A wildcard was found in the command . 
User Act i on : Reenter the command without wildcards. 
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3.2.6 Using OVL 



OVL is used to read a logfile and produce a report showing the 
disk resident overlay activity for a task. 

A memory-resident overlay segment is loaded from disk the first 
time that the segment is referenced. If a task has memory- 
resident overlays, OVL wi 1 1 count their initial 1 oads in the 
overlay report. Subsequent memory-resident overlay "loads" 
will not be counted, since a disk load is not performed. 

OVL has two input files : 

1) A mapfile for the task whose disk resident overl ays 
are to be analyzed . 

2) A logfile. 

In addition, the taskname switch /TSrtsknam must be appended to 
the logfile specification. If the taskname specified by 
/TSrtsknam is a generic taskname , e.g., ...XYZ, then all 
overlay hook records with the same generic taskname will be 
analyzed for the overlay report . If the taskname is not 
generic (not of the form ...XYZ), then only the hook records 
whose tasknames exactly match the /TS rtsknam taskname wi 1 1 be 
analyzed for the overlay report. 

The overl ay report lists al 1 the segment names for a task and 
prints the number of times each segment was loaded. 

In addition, you can trace each o ve r 1 ay load by using the /TR 
switch on the output file. As each overlay hook record is 
read, the segment name and the number of times that segment has 
been loaded up to that point will be printed. 

The command syntax for OVL i s : 

>RUN OVL 

0VL> OUTFILE/SW = MAPFILE, LOGF ILE/TS rtsknam 
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V L Switches 



Swi tch def aul ts -- 

output : SY .-TRACE .RPT/-TR 

input mapfile: SY .-TRACE .MAP 

input logfile: SY :TRAC E . LOG/DE :800/RW/SK :0 



Output 
Swi tches 


Descri pti on 


/ T R / - T R 


Print a t r a r p nf parh nvprlav cpnmpnt 

II I1IU U UIUV^C \J 1 CO t [1 U V C 1 1 UJ o C VJIIIC II I 9 

giving the segment name and the number of 
times the segment has been loaded up to that 

p U 1 El L • 


Input 

Switches 

( to logfile) 




/ TS :t s k n am 


This switch is required. I f "ts knam" is of 
the form . . . X YZ , all hook records with same 
generi c task name wi 1 1 be included for 
overlay analysis; if "tsknam" is not of the 
form . . . X Y Z , then only hook records with 
tasknames exactly matching "tsknam" wi 1 1 be 
included for overl ay analysis . 


/DE :nnnn 


Sel ects input magtape DEnsity, 800 or 1600 
(ignored unless /RW is all used) 


/RW /-RW 


Rewind tape input file before opening 


/SK :nnn 


Skip n n n files when opening tape input file 
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OVL Messages 

The OVL messages are i ssued to the TI device under whi ch OVL is 
run. Thi s section discusses the messages which OVL can issue. 

OVL DSW :###### F . ERR :###### IOSB :###### ###### PC :###### 

SP :###### 

OVL -- STK :###### ###### . « . 

Explanation: Thi s is a status message whi ch gives 
detail of the internal state of OVL at the time when 
an error is detected . This message is always followed 
by one of the messages discussed below, whi ch 
descri bes the actual error condition. 

User Action : See action specified for the message 
issued immedi ately after this status message. 

OVL -- COMMAND READ ERROR 

Explanation: An I/O error occurred while reading the 
command line. 

User Action: Reenter the command. 
OVL -- COMMAND SYNTAX ERROR 

Explanation : The command has improper syntax . 

User Action : Reenter the corrected command . 
OVL -- COMPLETION ERROR IN INPUT READ 

Explanation : an I/O error occurred whi 1 e readi ng the 
input file. This condition, which may be symptomatic 
of a corrupted 1 o g f i 1 e , will be treated as 
end-of -f i 1 e . 

User Action: Check F.ERR and IOSB for error cause, or 
use another 1 ogf i 1 e . 

OVL -- ERROR ASSIGNING INPUT DEVICE 
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i n p u t f i 1 e . 



User Act i on : Check DSW and F .ERR for cause. Ensure 
the filespec syntax is correct. 
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OVL -- ERROR ASSIGNING OUTPUT DEVICE 

Explanation: OVL was unable to assign a LUN to the 
output file. 

User Act i on : Check DSW and F . ERR for cause. Ensure 

the f i 1 espec syntax is correct . 

OVL -- ERROR ATTACHING , POSITIONING OR SELECTING DENSITY OF 
MAGTAPE 

Explanation : An I/O error occurred when attempting to 
open a file on magtape. 

User Act i on : Ensure the drive is mounted f orei gn . 
Correct the error indicated by DSW or IOSB. 

OVL -- ERROR CLOSING INPUT FILE 

Explanation; An I / error occurred when closing the 
input file. 

User Act i on : None . 

OVL -- ERROR CLOSING OUTPUT FILE 

Explanation : An I/O error occurred when closing the 
output file. 

User Act i on : Correct the condition and rerun OVL or 
manually unlock the output file. 

OVL -- ERROR IN INPUT READ QIO 

Explanation : An I/O error occurred wh i 1 e reading the 
input file. This condi ti on , which may be symptomat i c 
of a corrupted logfile, wi 1 1 be treated as 
end-of -f i 1 e . 

User Action : Check DSW for cause. Rerun using 
another logfile if necessary. 

OVL -- ERROR READING MPB 

Explanation: An I/O error occurred when reading the 
first block of the logfile. 

User Act i on : Correct the condi ti on and rerun . 
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ERROR PARSING MAP FILE 

Explanation: OVL could not parse the specified file 
into overlay segment names and segment block numbers. 

User action: Input a valid map file. 

ERROR PRINTING OVERLAY SUMMARY 

Explanation: An I/O or formatting error occurred when 
attempting to print the summary section of the overlay 
report. 

User action : Correct the condition and rerun . 
ERROR PRINTING OVERLAY TRACE 

Explanation: An I/O or f ormatt i ng error occurred when 
attempting to print the trace section of the overlay 
report. 

User action: Correct the condition and rerun. 

INCONSISTENCY BETWEEN MAP FILE AND LOG FILE 

Explanation: The overlay block numbers in the logfile 
for task specified by /TS:tsknam do not appear in the 
map file. 

User Action: Be sure the map file is correct for all 
tasks in logfile with generic taskname specified by 
/ TS :t s k n am . 

INPUT F ILESPEC OR SWITCH SYNTAX ERROR 

Explanation: A syntax error was detected in the input 
f i 1 e s p e c . 

User Action: Reenter the corrected command. 

INVALID DENSITY SELECTED, 800 OR 1600 ONLY 

Explanation: A magtape density other than 800 or 1600 
was specified. 

User Action: Reenter the command with a correct 
density. 
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OVL -- INVALID INPUT DEVICE TYPE 

Explanation : An attempt was made to read a file not 
on disk or tape . Disk and tape are the only 
acceptable med i a for 1 ogf i 1 es . 

User Act i on : Do not use OVL to read files not on disk 
o r tape . 

OVL -- INVALID MPB FOUND 

Explanation : The first block of the input file does 
not pass certain validity tests which ensure the file 
is a logfile. This may be caused by a corrupted or 
obsolete logfile. 

User Action : Use a different logfile. 
OVL -- MORE THAN TWO INPUT FILES PECS NOT ALLOWED 

Explanation : The command has improper syntax . 

User Act i on : Reenter the corrected command. 
OVL -- MORE THAN ONE OUTPUT F ILESPEC NOT ALLOWED 

Expl anati on : The command has improper syntax. 

User Action : Reenter the corrected command. 

OVL -- MPB NOT FOUND - NOT TRACE FILE 

Explanation: The first block of the input file does 
not pass certain validity tests which ensure the file 
is a logfile. This may be caused by a corrupted or 
obsolete logfile. 

User Action : Use a different logfile. 

OVL -- OUTPUT FILESPEC OR SWITCH SYNTAX ERROR 

Explanation : A syntax error was detected in the 
output f i 1 espec . 

User Action: Reenter the corrected command. 
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OVL ~~ OVERFLOW BEFORE MPB - BAD TRACE FILE 

Explanation: The first block of the input file does 
not pass certain validity tests which ensure the file 
is a logfile. This may be caused by a corrupted or 
obsolete I o g f i 1 e . 

User Act i on : Use a di f f erent logfile. 

OVL -- TRUNCATED INPUT FILE RECORD 

Explanation: The end of a buffer was reached before 
all records in that buffer were processed. This 
indicates a corrupted logfile. 

User Act i on : Use a different logfile. 

OVL -- UNABLE TO OPEN INPUT FILE 

Explanation : An I/O error occurred while opening the 
i n p u t f i 1 e . 

User Action: Correct the condition and rerun. 
OVL -- UNABLE TO OPEN OUTPUT FILE 

Expl anati on : An I/O error occurred while opening the 
output file. 

User Act i on : Correct the condition and rerun. 
OVL -- UNKNOWN RECORD TYPE 

Explanation: An unknown record ID was found in the 
file. 

User Action: Use a different logfile. 

OVL WILDCARD NOT ALLOWED IN FILESPEC 

Explanation: A wildcard was found in the command. 
User Action: Reenter the command without wildcards. 
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3.2.7 Writing User Information to the Logfile 

The QPDRV driver provides a way for a user task to write user 
i nformati on to the same logfile that COL currently has open. A 
task does this by issuing a Q 1 to QP : , with up to six words 
o f user information specified in the Q 1 parameter words . 

The QPDRV driver is similar to the null driver NLDR V . 1 1 is a n 
infinite sink for writes and a n infinite source of EOFs for 
reads . QPDRV is compat i bl e with FCS and RMS Q 1 functions . 
Al 1 o f the f o 1 lowing Q 1 functions are defined as legal and 
control for QPDRV: IO.KIL, IO.RLB, IO.WLB, 10. ATT, IO.DET, 
IO.FNA , I0.ACR, IO.ACW, I . AC E , I0.DAC, iO.RVB and IO.WVB. 

QPDRV contai ns a hook point defined as H$USER. When a Q 10 is 
issued to QP : , a hook record with hook I D H$USER is written. 
The H$USER record contains the six QIO parameter words speci- 
fied by the user. See Appendix A for a complete specification 
o f the hook record. 

To use QPDRV , you must load it by the command : 
>L0A QP : 

QPDRV is built vi a the command file PM0NBLD.CMD. The image and 
symbol table files for QPDRV are contained in [ 1 ,54] . 

Ex amp 1 e : 

ALUN$C 1 ,QP ,0 

Q I 0W$C I0.WLB ,1 ,1 , , , , < 100 ,200 ,300 ,400 ,500 ,600> 

will result in a H$USER record with the Q 1 parameters 100 , 
200 , 300 , 400 , 500 and 600 written to the logfile. 

To dump a stream of H$USER records in the performance report, , 
you run MDR and use the /DM:40 switch. I f you only want the 
H$USER records printed , the suggested command syntax is: 

MDR> output = i nput/DM :4 0/ L I :0/SI :0 

Usage note : If you enable device type "OTHER" in SMPGEN, then 
for each QIO to QP:, three hook records are written: H $ Q D R V , 
H$ I0DN and H$USER . However, if you disable device type "OTHER" 
in SMPGEN , then for each QIO to QP : only the H$USER hook record 
is written. 
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Chapter 4 



DATA COLLECTION AND 
REDUCTION PROCEDURES 



COL and MDR are complementary tools which can be used to 
collect large amounts of performance data and i nterpret the 
data to a great degree of precision. Both COL and MDR have a 
numbe r of parameters and switches which provide flexibility in 
both collecting and interpreting the data. In the f ol 1 owi ng 
sections we desc ri be how to utilize the parameters of COL and 
MDR to collect the best possible set of data to analyze your 
compute r system. 



4.1 DATA COLLECTION PROCEDURE 

There are a number of questions you should answer before 
running COL to collect data: 

o Length and type of measurement interval? 

o Resource types enabled for data col 1 ecti on? 

o Device classes enabled for data col 1 ecti on? 

o Tas ks enabled for data col lection? 

o System metrics enabled? 



The measurement period is def i ned as the t i me during which COL 
is col 1 e c t i n g data . Typ i ca 1 1 y this time is one conti nuous time 
i nterval ; however , it may consist of a number of time intervals 
piece w i s e added together. 



4.1.1 



Measurement Period 
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Under most conditions, you should select a continuous measure- 
ment period. This is done by runni ng COL either in MANUAL mode 
or AUTOSTOP mode . 

MANUAL mode should be used when : 

o There is an operator available to terminate COL. 

o You estimate the 1 o g f i 1 e space available is sufficient 
to contain all the data col 1 ected for the measurement 
period. 



AUTOSTOP mode should be used when : 

o An operator is not available to terminate COL. 

o You want to run COL for a fixed amount of time 
(AUTOSTOP on TIME) . 

o You want to set a limit on the amount of logfile space 
used (AUTOSTOP on BUFFER) . 



Under some conditions , particularly if the system is under 
heavy acti vi ty for long periods of time, COL will collect too 
much data given the available logfile space. To reduce the 
logfile space used, you can run COL in REPEAT mode . However , 
you should do so carefully. The chief concern when running COL 
in REPEAT mode is that " i ncomp 1 ete intervals" may result if a 
task o r operation is outstandi ng exactly when COL starts or 
stops data col 1 ecti on . For example , if you start COL precisely 
when a task is active and has an I/O operation queued to the 
disk, a n incomplete interval wi 1 1 be flagged by MDR for both 
the task invocation and for the I / operation. This condition 
does not i n v a 1 i d a t e other i nf ormati on in the performance 
report , it just "leaves out" some information which potenti al ly 
may be valuable. You can minimize the number of incomplete 
intervals by minimizing the number of times COL enables or 
disables data collection for a measurement period. 

Let's say you want to collect data during a normal 8 - h o u r 
daytime shift and you have only one 2400 foot magtape available 
for the logfile. However , you estimate that if COL runs all 
day , about two 2400 foot tapes will be needed. What you need 
to do is cut the amount of data col 1 ected in half. Consider 
the f o 1 lowing al ternati ve measurement schemes : 

o Sample time = 1 minute; Time between samples = 
1 mi nute . 
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o Sample time = 3 minutes; Time between samples = 
30 minutes. 

o Sample time = 2 hours ; Time between samples = 
2 hours . 



Scheme 1 will usually result in the highest number of 
incompletes , yet it probably will not " miss " any important 
system act i v i ty . Scheme 3 will probably result in the 1 owes t 
n umbe r of i ncompl etes , yet it is vul nerabl e to missing 
i mportant intervals of system act i v i ty . Scheme 2 will probably 
res ul t in a 1 ow number of i ncompl etes , yet it has a good chance 
of capturi ng a 1 1 periods of important system act i vi ty . 

What we're observing here is an old problem in commu n i ca t i on s 
systems: How fast do you sample a signal to be able to 
reconstruct the signal from the sampled data? I n our case, the 
problem is: how fast do you sample the workload in order to 
recons t ruct it? 

I n commu n i cat i on systems , you sample the signal at twice the 
highest frequency in the signal . I n computer systems, it would 
be reasonable to s amp 1 e the wo r k 1 o a d at twice the highest 
frequency of variation in the workload. Thus if you observe 
the' workload to fluctuate up and down about four times per 
shift , then 8 sampl es per shift (every 30 minutes) would reduce 
the amount of data and yet collect sufficient data to 
reconstruct the workl oad . 



4.1.2 Resource Types 

Normally you want to collect data for a 1 1 resource types (CPU, 
memory , I/O). I f the amount of data collected is too large, 
you can select one resource type per measurement period and run 
a number of measurement periods. 

The hooks are grouped accordi ng to resource type. To select a 
particular resource type , you select the corresponding hook 
group. 



4.1.3 Device Classes 

The device classes are: Di rectory , Sequenti al , Terminal , and 
Othe r . I f you want to measure the resource contention for a 
device, select it for data coll ecti on . Normally the disks are 
shared devices and should be sel ected . I f the line printer is 
spool ed and attached to the despooler task you may not need to 
collect usage data for it. Similarly, terminals are normally 
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singly used by one task a t a time; the measurement results may 
not be useful from a resource contenti on point of view. 



4.1.4 Tasks 

The tasks selected for data collection are the definition of 
the workl oad that you want to measure. For example , if you 
want to analyze the a p p 1 i c a t i o n workload, select a 1 1 the tasks 
in that workl oad and deselect the system service tasks such as 
F 1 1 AC P , MC R . . . , and QMG . . . . On the other hand , if you want to 
measure the system resources that a particular F11ACP is 
consuming, enable only F 1 1 AC P and disable all other tasks . 



4.1.5 System Me tries 

Normally system metrics should be enabled with a sample 
interval of 60 seconds. I f you want to save logfile space and 
report paper , 1 on ge r sample intervals may be used . 



4.2 DATA REDUCTION PROCEDURE 

Once you have a logfile on disk or tape , you are ready to read 
the logfile with MD R and reduce the data to a usable perfor- 
mance report. A guide to reading the performance report is 
given in Chapter 5. 

The data reducti on procedure should consist of a number of 
steps methodical 1 y pe r f o rmed . A general guideline is to first 
obtain a number of overviews of the system activity during the 
entire measurement period and then print detailed analyses of 
the subset measurement intervals of interest. For example, if 
during an 8 hour shift there were two intervals of peak 
act i v i ty , from 9 to 1 1 a.m. and from 2 to 4 p.m., you should 
first run MD R with /LI :0 to get a system metrics scan of the 
entire 8 hour shift, and then run MD R with / AF and / B F to get a 
report of only the peak morning activity and again with / AF and 
/ B F to get only the peak afternoon activity. The general 
procedure is as follows : 

o Run MDR with /LI : for entire logfile. 

Identify the i nterval s of interest and record their 
endpoints of time using the KW11-P clock t i mes t amp s 
pri nted above the system metrics. 

o Rerun MDR once for each subset measurement interval 
using /AF and /BF with the /LI : 2 switch. 
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This will give both system and task 
Identify the largest consumers of resources 
their tas knames . 



s umma r i es . 
and record 



Rerun MDR with /LI : 4 or /LI. -5 and /TS for the tasks 
desired. 

Observe a detailed analysis of the particular tasks 
which cons umed the resources and the times when these 
resources were consumed. 
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Chapter 5 

READING THE 
PERFORMANCE REPORT 

5.1 PERFORMANCE REPORT DATA 

When reading this section , refer to Appendix F , which contains 
a sample performance report. 

The performance report consists of four sections: 
o Measurement Parameters 
• o System Configuration 
o System Metrics 
o Task Metri cs 

5.1.1 Measurement Parameters 

The measurement parameters are read from the Monitor Parameter- 
Block (MPB) which is the first block of the 1 o g f i 1 e . The MDR 
task extracts the information from it and prints the measure- 
ment parameters on the first page of the performance report . 
The i terns pri nted are: 

o Label . 

o Measurement mode. 

o Buffer type , partition , number and size, 

o Resources selected for System Metrics, 

o T I filter device (if selected), 

o Tasks selected for data collection. 
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Devices selected for data collection. 



o Hooks enabled, 
o MDR command line. 



5.1.2 System Configuration 

The system configuration i n f ormat i on is contained in the 
In format i on Records and directly follows the MPB in the 
1 o g f i 1 e . I f the /SC switch is specified , the MDR task will 
extract the i n f ormat i on from these records and print it to the 
logfile. The i nf ormati on printed is: 

o The Pool ( DSR ) size in bytes and the executive feature 
masks . 

o A list of the partitions in the system when COL was 
activated. 

o A list of the control 1 ers and units in the system when 
COL was a c t i vated . 

o A list of the tasks installed in the system when COL 
was act i vated . 

o A list of the active checkpoint files and their sizes 
when COL was activated. 



5.1.3 System Metri cs 

The system met r i cs are system-wide meas u rements of CPU usage, 
pool usage, the usage of a selected partition, checkpoint file 
usage, and the usage of a selected device. Measurements are 
made for each sampling interval and the results written to the 
logfile. The length of the sampling interval is sel ected in 
the SMPGEN.CMD procedure. The system metrics are : 

o CPU Usage 

For each sampling interval , counters are kept for the 
total times spent in kernel and idle states . The 
remainder of the sampling interval time is assumed to 
be user state. To depict CPU usage, a histogram is 
printed on the performance report. Each 1% of time 
spent by the CPU in user mode is represented by a 
single letter "U" . Each 1% of time spent by the CPU 
in kernel mode is represented by a single letter " K " . 
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The user time is left justified and grows from left to 
right; the kernel t i me is right justified and grows 
from right to left. I f any blank spaces exist in the 
line, they represent CPU idle time. 

Pool Usage 

At the end of each sampling i nterval , 
RSX-11M system pool and measures the 
pool in use. The percentage of 
rep resented by a histogram, where each 
1% o f pool usage. 

Partition Usage 

The user selects a partition to be monitored v i a the 
COL switch /PR rparnam. At the end of each sampling 
i nterval , COL scans the partition data structures for 
the selected partition to measure the percentage of 
the memo ry in use in the partition. The percentage of 
m e in o r y used in the partition is represented by a 
histogram, where each " M" represents 1% of partition 
usage. 

Checkpoint File Usage 

When COL is activated, it scans the checkpoint file 
list and records a list of a 1 1 active checkpoi nt files 
and their si zes . 

At the end of each s a m p 1 i n g interval , COL scans the 
checkpoi nt file list and meas u res the percentage of 
all active checkpoint file space in use . I f there is 
more than one checkpoint file, COL sums the space in 
all checkpoint files to compute the percentage. The 
percentage of checkpoi nt file space used is repre- 
sented by a h i s tog ram , where each "C " represents 1% of 
checkpoint file space usage. 

Device Usage 

The user selects a device to be monitored v i a the COL 
switch / D V :dd n n . For each sampling interval , COL 
tallies a 1 1 the I / request times for the selected 
device to get the percentage of time that the I / 
device was in use during the sampl i ng i nterval . The 
percentage of time the device was used is represented 
by a histogram, where each "D" represents 1% of device 
usage time for the sampling interval . 



COL scans the 
percentage of 
pool used is 
"P" represents 
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I n addition , if the device is a Files-11 disk and is 
mounted native, the number of disk blocks used on the 
vol ume is computed at the end of the sampling 
interval. The percentage of disk space used is 
represented by a histogram where each " B " represents 
1% of the total volume space used. 



For each sampling interval , the histograms for CPU, pool , 
memo ry , checkpoint file space , and device are cl ustered 
together into six successive lines on the report. 

The end of each sampling interval is timestamped and printed in 
two formats : KW11-P time and RSX- 1 1M system time. 

The KW11-P time is printed a s two octal numbers : the left 
n umber is the high order part and the right number is the 1 o w 
order part. The corresponding RSX-11M system time is printed 
as HRS :MIN :SEC .TENTHS. 

The K W 1 1 - P timestamp can be used to : 

o Correlate a n individual task report page (which has 
the same form of timestamp) with a particular system 
metric line. 

o Select a particular measurement interval of interest 
by rerunning MDR using the / AF and /B F switches . 



The totals for CPU kernel time, CPU idle time and device busy 
time are given for each measurement i nterva 1 . 

The last item in the system metrics secti on is the "Total Data 
Reduction Period" . This is the total time for which data was 
reduced. If the report was generated using the /AF and / B F 
switches, only the data reduced between /AF and /BF is counted. 



5.1.4 Task Met ri cs 

Levels of Task Summari zati on 

The task metrics describe the usage of the resources in the 
system on a task-by-task basis. There are a number of levels 
of summarization available in the p e r f o r in a n c e report , which 
enables the user to choose between a very detailed report or a 
shorter summarized report. The levels of summarization and 
their corresponding switches are as follows : 
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o Individual Task Invocations (/LI. -4 or /LI : 5 ) 

An individual task invocation is defined as a single 
run of a task, that is, the time between an executive 
Run Task event and an executive Exit Task event (the 
exact placement of the hooks for these events is 
specified in Appendix A). A complete set of task 
metrics will be printed for each task invocation. If 
most or all tasks in the system are enabled for data 
collection, a report containing individual task 
invocations may be quite long. 

o Task by TI Summary (/LI : 3 ) 

In this level of summary, the task metrics for tasks 
with the same generic taskname (see Chapter 2, section 
2.2.2) and the same TI are grouped together when the 
statistics are computed. The task metrics then reveal 
the measurements summed across all tasks with the same 
generic taskname from the same TI. 

o Task Summary (/LI :2) 

In this level of summary, the task metrics for tasks 
with the same generic taskname (see Chapter 2, section 
2.2.2) are grouped together when the statistics are 
computed. The task metrics then reveal the measure- 
ments summed across all tasks with the same generic 
tas kname . 

o System-Wide Summary (/LI : 1 ) 

In this level of summary, the task metrics for all 
tasks in the system that were enabled for data 
collection are grouped together when the statistics 
are computed. The task metrics then reveal the 
measurements summed across all tasks in the system. 

Task Metric Data 

The following data is presented in the performance report for 
all levels of task summarization. 

o Generic TASK 

The generic taskname (see Chapter 2, Section 2.2.2) is 
printed on the top of the page to identify the task 
for which the data applies. 
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Elapsed Times 



The elapsed time is the time from a Run Task event to 
an Exit Task event. 

o Number of Task Invocations 

The Number of Task Invocations is the number of times 
that a Run Task event occurred for the task. If the 
COL task is started while a task is in progress, the 
Run Task event will not be recorded in the logfile for 
that task. When the task exits, an Exit Task event 
will be recorded to the logfile. When MDR reads an 
Exit Task event without a corresponding Run Task 
event, it reports an "incomplete" invocation in the 
Number of Task Invocations line. 

o Memory Times 

There are three memory times : 

In (memory) 

Out (memory) - includes time waiting for memory on 
initial task load and all time checkpointed 
(waiting and stopped). 

( 

Wait (memory) - includes time waiting for memory on 
initial task load and time checkpointed (waiting 
only ) . 



o Memory Size in K Words 

Size of the task region. 

o Space-Time Product 

The space-time product is the amount of memory that a 
task uses integrated over the time that the memory was 
used. Each increment of memory used (in K words) is 
multiplied by the time (in SECs) that the increment 
was used, and all products are summed to get the 
space-time product. If a task changes its size via an 
Extend Task directive, the corresponding change in 
memory usage is computed. 
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ACP Counts 



The AC P Counts are tallied across all ACPs in the 
system. They are not broken down by separate ACP. 

There are seven categories of ACP functions printed on 
the performance report. They are: 

Access/Deaccess 

These functions are: Access File for Read, Access 
File for Read/Write, Access File for Read/Write/ 
Extend, Deaccess File, Connect Logical Link, and 
Disconnect Logical Link, and Close Out LUN. 

Create/Delete 

These functions are: Create File, Delete File and 
Truncate File. 

- Read/Write 

These functions are: Read Virtual Block, Write 
Virtual Block, Receive Message and Transmit 
Message. 

Di rectory 

These functions are: Find File Name in Directory, 
Enter File Name in Directory and Remove File Name 
from Di rectory . 

- File At tribute 

These functions are: Read File Attributes and Write 
File Attributes. 

Extend 

This is the Extend File function. 

- Other 

These functions are all ACP functions other than 
those listed above, such as: Unlock Block, User 
Magtape Control Function and Network Control 
Function. 
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Memory Residency 



The Memory Residency count is incremented each time a 
task successfully allocates memory for an initial task 
load or for a checkpoint read. 

CPU Timeslices 

A CPU Timeslice is the time between a Load Task 
Context event and a Save Task Context event, minus the 
idle time accrued during that period. Note that if a 
task issues a directive and the processor switches to 
kernel mode, the corresponding time in kernel mode is 
charged to the active task's CPU timeslice. Also, if 
an interrupt occurs while a task's context is active, 
the corresponding kernel mode time is charged to the 
active task's CPU timeslice. 

Initial Loads 

Initial Loads is the number of Initial Task Load 
events for the task. The USAGE times indicate the 
time it took the loader task to load the task; the 
WAIT times indicate how long a task's load request was 
in the loader task's queue. 

Checkpoint R+W 

Checkpoint R + W is the number of Checkpoint Read and 
Checkpoint Write events for the task. The USAGE times 
indicate the time it took the loader task to check- 
point (read or write) the task. (Note: the USAGE 
times do not indicate how long a task was check- 
pointed. This information appears under "Memory 
Times" on the task metric page.) 

DDnn Ovly Loads 

DDnn Ovly Loads is the number of overlay read (IO.LOV) 
QIOS the task issued to device DDnn. 

DDnn QIOs 

DDnn QIOs is the number of logical QIOs a task issued 
to device DDnn. Please not e the fo llowing caveats: 

DDnn Ovly Loads is included in this count, since 
IO.LOV is a Logical block QIO. 
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USAGE Times 



Task IO.RVB and IO.WVB (virtual) QIOs which are 
successfully and entirely mapped by the executive 
or F11ACP to IO.RLB and IO.WLB (Logical) QIOs are 
included inthiscount. 

Task IO.RVB and IO.WVB (virtual) QIOs which are 
sent to F11ACP, and which are performed by F11ACP 
on behalf of the task (partially mapped, multiple 
transfers), are not included in this count. This 
logical block i/u is charged to F11ACP. 

The 10. ATT, IO.DET and IO.KIL QIOs are not included 
in this count. 

Drivers for devices with the characteristic UC.QUE 
may directly process an I/O request without the IRP 
being queued. This will cause an incomplete 
measurement of Usage and Wait times. (e.g. TT :) 



The USAGE times indicate how long a task used a resource. 
WAIT Times 

The WAIT times indicate how long a task was waiting for the use 
ofaresource. 



SERVICE Times 

The SERVICE time is the USAGE time plus WAIT time which 
occurred for each resource request. Note that the minimum 
SERVICE time is not necessarily equal to the minimum USAGE time 
plus minimum WAIT time, since the minimum USAGE time may have 
occurred for a different resource request than the resource 
request which had the minimum WAIT time. The same applies to 
the maximum. 



ARRIVALS PER SECOND 

The mean task rate is the number of resource requests issued by 
a task divided by the task's elapsed time . It tells, from a 
task's point of view, the rate of resource requests issued by 
a task. The mean system rate is the number of resource 
requests issued by a task divided by the data reduction period. 
It tells, from a resource' s point of view, the rate of resource 
requests issued by a task. 
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Resource Metrics 

For each resource used by a task, the following metrics are 
printed on the report: 

o Count 

The number of times a task used a resource, 
o Total Time 

The total time during which a task used the resource 
(equal to the sum of all resource usage intervals). 

o % Resident Time 

% Resident Time is (Total Ti me/ Res i dent Time) * 100%. 

o Minimum 

The smallest interval during which a task used a 
resource . 

o Mean 

The arithmetic average of all resource usage intervals 
for a task. 

o Maxi mum 

The largest interval during which a task used a 
resource . 

o Coefficient of Variation 

The coefficient of variation is the standard deviation 
of the intervals divided by the mean interval. 

o % Resource 

% resource is the total time a task used the resource 
divided by the total time of the Data Reduction Period 
(total resource time available). 

o Incomplete 

If the logfile does not contain a "complete" set of 
events needed to define an interval, MDR will tally 
the interval as an "incomplete". For example, if MDR 
reads a I/O Done event from the logfile for a certain 
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task and device and there is no corresponding Get I/O 
Packet event for the task and device, MDR will regard 
the I/O interval as an incomplete. Incomplete 
intervals can occur if COL starts data collection 
while an operation (interval) is already in progress. 

The only data recorded for incomplete intervals is the 
count; no timing information is computed since the 
information is not precise. 

Incomplete intervals are printed in lieu of the % 
resource metric if the /IC switch is specified. 
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Chapter 6 



RESOURCES USED 
BY SPM-11M 



The purpose of this section is to give an estimate of the 
resources used by the COL and MDR tasks. 



1 RESOURCES USED BY COL 
o CPU 

When a task metric hook is encountered, from 50 to 75 
instructions are executed at system level (PR=0, 
$STKDP = 0) before returning to the main flow of the 
execut i ve . 

o System Pool 

When the COL task is inactive, about 115 words of 
executive space are used. This is accounted for by 
the hook points (3 words per hook), 4 words added to 
system common, 16 words added to the system stack and 
a dummy hook return routine added to SYSXT. 

When the COL task is activated, approximately 215 more 
words of system pool are used. 

o Physical Memory 

The COL task occupies about 4K words of physical 
memory. The COL buffers (either in a static common or 
dynamic region) can vary from 0.5K words to 32K words. 
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o I/O Requests 

The COL task issues a FCS WRITE$ to write a buffer to 
disk; it issues a Q 1 $ to write a buffer to magtape. 
The rate of I/O requests generated by COL depends on 
the system activity that COL is tracing. 



6.2 RESOURCES USED BY MDR 
o Memory 

The code and static data of MDR requires varying 
amounts of memory depending upon which version is 
built. See the TASK IMAGE SIZE in MDR. MAP. 

Additional space is required for I/O buffers and 
dynamic structures which are manipulated within MDR's 
virtual address space. MDR will automatically extend 
its virtual space as needed to accommodate these 
structures. Typically MDR will require an additional 
8KW for all the dynamic storage. 

o Pool 

All MDR I/O is singly buffered, and synchronous, 
minimizing the use of pool. 

o I/O 

Each pass of MDR reads a single file and writes to the 
report file. During pass I the RESOURCE. TMP file is 
also being written. Terminal I/O is used for command 
input, and error reporting. The DRS task will have up 
to 7 files concurrently opened for I/O. 
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Chapter 7 

SPM-1 1M USAGE NOTES 



7.1 TASKB U I LD I NG COL 

COL must be taskbuilt using the baseline library 
[1 , 1 ]S YSL IB . OLB (which does not contain FCS routines with ANSI 
or big buffering). 

If COL is taskbuilt with the ANSI or big buffering FCS 
routines, its size may be greater than 4096 words. The result 
will be that when COL is run, it will not be able to create an 
address window (the error received will be COLMSG -- CANNOT 
CREATE BUFFER PARTITION OR ADDRESS WINDOW). 



7.2 COL BUFFERS 

When COL starts up it copies three system lists to the logfile: 

1) TCBs , 

2) PCBs , 

3) DCBs-UCBs. 

There must be enough buffer space to store the largest of these 
three system lists, otherwise COL will print the error message 
COLMSG -- INFORMATION RECORD ALLOCATION FAILURE. 

Before COL is left to run unattended for long periods of time, 
COL should be run for 5 to 10 minutes under a typical heavy or 
peak system workload and the console terminal should be 
monitored for the occurrence of overflow errors, i.e., COLMSG 
-- BUFFER OVERFLOW. If buffer overflows occur, the buffer size 
for COL can be increased by using the /BF switch (see Chapter 
3, section 3.2.2). 

Another cause of COL overflows may be smal 1 disk file extent 
sizes . When COL attempts to write a buffer to the logfile, 
F 1 1 AC P may have to do an extend file operation before the 
actual data write can be done. The time it takes F11ACP to 
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extend a file may be long, and COL may overflow as a result of 
this. To remedy this situation, two switches have been built 
into COL : 

o Initial File Size /IF 

o Extend File Size /EX 

If an estimate can be made of the maximum logfile size before 
COL is run, it is best to preallocate all the logfile space via 
the /IF switch. In this case COL will not need F11ACP to do 
any extend file operations during its run and this may prevent 
overflows from occurring. 



7.3 STATE OF SYSTEM AT COL STARTUP TIME 

When COL starts up, it copies the TCBs , PCBs , DCBs and UCBs in 
RSX-11M to the logfile. The MDR task later refers to these 
data structures to derive the necessary context for printing a 
performance report. 

To assure that MDR will have all the context it needs to print 
the report, you should insure that the following conditions are 
satisfied before starting up COL: 

o All tasks installed 

If you want to disable a task for data collection, 
that task must be installed when COL starts up. All 
tasks dynamically installed after COL starts will 
always be enabled for data collection . This means 
that all multiple copies of a multiuser task will 
always be enabled for data collection. 

o All partitions set up 

If you want memory metrics kept for a partition, the 
partition must be set up 

(via SET /MAIN=XYZPAR :m :n :type) before starting COL. 
o All drivers loaded 

If you want the I/O metrics kept for a device-unit, 

•+- u a *y A k , *s a n a p i « n +• k ^ +- Ho\/irG_iini+ mn c t ho Ih^HpH 
U1IC u I IVCI ma ii a y i n y una I ucVfL-c — Uiiiu iHuj i- ^ c i w « « ^_ — 

before starting COL. 

The MDR program is not capable of analyzing a logfile 
which contains task event records for an I/O device, 
but no system configuration information for that 
device. To ensure that unusable logfiles are not 
created, no device driver database may be loaded while 
the task ...COL is active. 
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All devices mounted 



If you want the correct ACP taskname for a mounted 
volume to be printed on the performance report, the 
volume must be mounted before starting COL. Other- 
wise, MDR will print a "pseudo" taskname for the ACP. 

Example: If the device D K 1 : is mounted to the F11ACP 
task after data collection is in progress for COL, MDR 
will print the pseudo name DK1***ACP on the report. 



All checkpoint files allocated 

If you want the system metrics for checkpoint file 
usage, be sure to allocate all checkpoint files with 
the ACS command before starting COL. 
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7.4 T AS KB U I L D I N G MDR 



MDR will run on processors with 
ing point processor) support, 
hardware FPP, it must minimally 



or without hardware FPP (float- 
If your processor does not have 
have hardware EIS instructions. 



You must taskbuild MDR to reflect the type of hardware (FPP or 
EIS) on your processor. You can build MDR either overlaid or 
non-overlaid with both FPP and EIS versions. To build MDR, 
invoke the build command file: 

>@MDRTKB 

This command file will prompt you to build any of the four 
available versions: 

1. FPP support, overlaid 

2. FPP support, non-overlaid 

3. EIS support, overlaid 

4. EIS support, non-overlaid 

You can change certain MDR defaults by editing the taskbuild 
command file produced by MDRTKB.CMD. The MDRTKB.CMD procedure 
will prompt you for changing the defaults. The defaults which 
can be changed are: 

o Number of lines per page in REDUCE. RPT file 

o Default values for /LI switch 

o Default values for /SI switch 

o Default magtape logfile density (/DE) 

o Default value for /DM switch 

o Whether MDR automatically spawns DRS 



7.5 NECESSARY UFD TO RUN MDR 

The intermediate files used by MDR will always be created in 
the directory SY:[current UIC]. Therefore to run MDR, this 
directory must exist, on a mounted Files-11 disk. 
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7.6 MANUALLY EXECUTING THE DRS PASS 



MDR cannot determine whether DRS has completed successfully or 
with errors. If errors are likely in this pass (e.g., 
available disk space is minimal) manual intervention to execute 
the DRS pass may be desirable. MDR will issue instructions for 
this manual operation if either of the following two conditions 
are true: 



MDR is built with the GB L PAT which prevents automatic 
spawn of DRS, or 

The task ...DRS is not installed when MDR is running. 



7.7 TASKBU I LD I NG CLF 

Generally CLF need not be taskbuilt since it is supplied as a 
task image. However to change defaults or apply patches, the 
build command file is invoked: 

>@MDRTKB 

The defaults which may be changed are: 
o default magtape density, and 

o default value of the /FCS:nn switch (if specified as 
/FCS) 



7.8 USE WITH LAYERED PRODUCTS 



SPM-11M inserts hooks into the RSX-11M executive at standard 
places where the executive does allocations and deallocations 
of resources . 



SPM-11M measures kernel CPU time by hooking the standard 
interrupt save ($INTSV, $INTSE, $1 NTSC ) and system exit 
($DIRXT) points. 

If any layered product or user privileged component uses 
nonstandard techniques for resource allocation or interrupt 
entry, the SPM-11M measurements will be inaccurate. 

For example, DECNET uses a nonstandard interrupt save routine, 
which means the kernel CPU time measurement will be inaccurate. 
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The COL task sets a status bit (MS. SYS) whenever a system 
entrance occurs. When a system exit occurs, COL checks that 
MS. SYS is set; if not, then COL has seen a system exit event 
without a corresponding system entrance event. COL will then 
simply ignore the system exit event and not add any kernel time 
in to the running total. Thus if layered product software 
receives interrupts via nonstandard drivers, the kernel mode 
time accrued from such interrupts will be ignored by COL. 



7.9 REPORTING PROBLEMS AND ERRORS 

A Software Performance Report (SPR) is used to report problems, 
errors, or suggested enhancements concerning SPM-11M. 

Whenever possible, the following information should be 
submi tted with the SPR : 

o A map of the failing component, 

o The MPB source file (TRACE. PAR), 

o The logfile on magtape (TRACE.LOG), 

o The faulty performance report ( REDUC E . RPT ) , 

o The faulty CLF output file on magtape, and 

o The faulty OVL output file. 

All magtapes will be returned. 
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Appsndix 

HOOK RECORD DEFINITIONS 



NOTE: All record offsets in this appendix 
are expressed in octal bytes. 

All record lengths are expressed in 
decimal bytes . 



■ 
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1.0 H$C DR P - CALL DIRECTIVE PROCESSOR 



1.1 LOCATION 



DRDSP.MAC 

After $EMTRP : : D I R S V $ 

After $DPLM2::M0V (SP)+,R3 

After 50$: MOV R5,R2 
Follow MOV $HE ADR ,R4 



1.2 DATA COLLECTION 



1.2.1 Storage Dependencies 



$TKTCB (Current Task TCB) 
$DICSV (Directive ID Code) 



1.2.2 Record Format 



Hook I.D 



Ti mes tamp 



Taskname (RAD50) 



TI UCB Address 



DIC 



12 
14 



1.2.3 Record Length 
14. bytes. 
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2.0 H$RTSK - REQUEST TASK TO RUN 



2.1 LOCATION 

. RE QSB . MAC 

After $TSKRP:: 
After 1$ : 

Follow MOV R2,T.UCB(R0) 

•* 

2.2 DATA COLLECTION 

2.2.1 Storage Dependencies - 
RO=TCB address 



2.2.2 Record Format - 



Hook I.D. 



Timestamp 



Taskname (RAD50) 



TI UCB Address 12 



Request UIC 14 



2.2.3 Record Length - 
14. bytes. 
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3.0 H$XTSK - TASK EXIT 



3.1 LOCATION 



DREIF.MAC 

After $C EX I T 
After 134$ : 
Fol 1 ow 



. E NDC ;P$$OFF 



3.2 DATA COLLECTION 

3.2.1 Storage Dependencies 
$TKTC B = TC B address 

3.2.2 Record Format - 



Hook I.D. 



Ti mes tamp 



Taskname (RAD50) 



TI UCB Address 



Id 1 et i me 



6 

12 
14 



3.2.3 Record Length - 
16. bytes . 
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4.0 H$SCTX - SAVE CONTEXT OF TASK 



4.1 LOCATION 



SYSXT.MAC 

After RESCH 
Fol low 73$ : 



CLR $RQSCH 

MOV H.GARD(R3) ,R2 



4.2 DATA COLLECTION 

4.2.1 Storage Dependencies - 
$TKTCB (Current Task TCB) 

4.2.2 Record Format - 



Hook I.D. 



Timestamp 



Taskname (RAD50) 



TI UCB Address 



Id 1 et i me 



12 
14 



4.2.3 Record Length - 
16 . bytes . 
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5.0 H$LCTX - LOAD CONTEXT OF TASK 



5.1 LOCATION 



SYSXT.MAC 

After RESCH 
After 120$: 
Fo 1 low 



CLR $RQSCH 

MOV H . GARD ( R2 ) ,R0 

. E NDC 



5.2 DATA COLLECTION 

5.2.1 Storage Dependencies - 

$TKTC B (TCB address of new task) 

5.2.2 Record Format - 



Hook I.D. 



Timestamp 



Taskname (RAD50) 



TI UCB Address 



Id 1 et i me 



12 
14 



5.2.3 Record Length - 
16. bytes . 
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6.0 
6.1 



H$USTP - UNSTOP TASK 



LOCATION 

REQSB .MAC 
After 
Fo 1 low 



$E XRQN : :B IT 
$EXRQU : :B IC 



#T2.STP*2!T2.STP ,T.ST2(R0) 
#T2.STP*2!T2.STP ,T.ST2(R0) 



6.2 DATA COLLECTION 

6.2.1 Storage Dependencies 
RO=TCB address 

6.2.2 Record Format - 



Hook I.D. 



Timestamp 



Taskname (RAD50) 



TI UCB Address 



6.2.3 Record Length - 
12. bytes. 



12 
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7.0 H $ Q AS T - QUEUE AST TO TASK 



7.1 LOCATION 



REQSB .MAC 

After $QASTT::ADD 
Follow CALL 

REQSB .MAC 

After $QUEXT:: 
Follow MOV 



#T . ASTL ,R0 
$SETCR 



R2 ,R0 



7.2 DATA COLLECTION 

7.2.1 Storage Dependencies 
RO=TCB address 

7.2.2 Record Format - 



Hook I.D 



Ti mes tamp 



Taskname (RAD50) 



TI UCB Address 




2 



12 



7.2.3 Record Length 
12. bytes. 
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8.0 H$EXTK - EXTEND TASK IN PLACE 



8.1 LOCATION 



DREXP.MAC 

After $DREXP::TSTB 
Follow 71$: MOV 



T. IOC (R5) 

Rl ,P.SIZE(RO) 



8.2 DATA COLLECTION 



8.2.1 Storage Dependencies 

$TKTCB=TCB address 
RO=PCB address 



8.2.2 Record Format - 



Hook I.D. 



Ti mes tamp 



Taskname (RAD50) 



TI UCB Address 



P.SWSZ 



12 



14 



2.3 Record Length - 
14. bytes. 
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9.0 H$QTRP - QUEUE TASK REQUEST FOR PARTITION 



9.1 LOCATION 



REQSB .MAC 

After $TSKRP 
After 7$: 
Follow 



MOV R1,R0 



9.2 DATA COLLECTION 

9.2.1 Storage Dependencies 
R0=TCB address 

9.2.2 Record Format - 



Hook I.D. 



Timestamp 



Taskname ( R AD 50 ) 



TI UCB Address 




2 



12 



9.2.3 Record Length - 
12. bytes. 
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10.0 H$QLDR - QUEUE TASK LOAD REQUEST TO LOADER QUEUE 



10.1 LOCATION 

REQSB .MAC 

Follow $LOADT::MOV $LDRPT,RO 



10.2 DATA COLLECTION 

10.2.1 Storage Dependencies 
R1=TCB address 

10.2.2 Record Format - 



Hook I.D 



Ti mes tamp 



Taskname (RAD50) 



TI UCB Address 



P. SIZE 



T.STAT 



12 
14 
16 



10.2.3 Record Length 



1 £. K W +" Q C 
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11.0 H$GLDR - GET REQUEST FROM LOADER QUEUE 



11.1 LOCATION 



LOADR . MAC 

After $LOADR : :CALL 
Fol 1 ow 10$ : MOV 



$SWSTK ,40$ 
Rl ,LDRTK 



11.2 DATA COLLECTION 

11.2.1 Storage Dependencies 
R1=TCB address 

11.2.2 Record Format - 



Hook I.D. 



Ti mes tamp 



Taskname (RAD50) 



TI UCB Address 




2 



12 



11.2.3 Record Length - 
12. bytes. 
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12.0 H$FLDR - FINISH LOADER REQUEST 



12.1 LOCATION 



LOADR . MAC 

After $LOADR::CALL 
Follow 84$: CALL 



$SWSTK ,40$ 
$SWSTK ,$LOADR 



12.2 DATA COLLECTION 

12.2.1 Storage Dependencies 
R5=TCB address 

12.2.2 Record Format - 



Hook I.D 



Ti mestamp 



Taskname (RAD50) 



TI UCB Address 



12 



12.2.3 Record Length 
1 2 . bytes . 
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13.0 H $ R L P R - RELEASE PARTITION 



13.1 LOCATION 



REQSB .MAC 

Fol 1 ow $RLPAR : :MOV 



13.2 DATA COLLECTION 

13.2.1 Storage Dependencies 
RO=TCB address 

13.2.2 Record Format - 



T.PCB(RO) ,R1 



Hook ID 



Ti mes tamp 



Taskname ( R AD 50 ) 



TI UCB Address 



T.ST2 




2 



12 



14 



13.2.3 Record Length - 
14. bytes. 
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14.0 H$QDR V - QUEUE I/O PACKET TO DRIVER 



14.1 LOCATION 



DRSUB .MAC 

Follow $DRQRQ : :MOV 



U.SCB(R5) ,R4 



14.2 DATA COLLECTION 



14.2.1 Storage Dependencies 

R 1 = I R P address 
R5=UCB address 



14.2.2 Record Format 



Hook I.D 



Timestamp 



Taskname (RAD50) 



TI UCB Address 



UCB Address 



Function code 



LUN 



IRP Address 



12 
14 
16 
20 
22 



14.2.3 Record Length - 
20. bytes. 
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15.0 H$GPKT - DRIVER GETS AN I/O PACKET 



15.1 LOCATION 



IOSUB .MAC 

After 
After 
Follow 



$GTPKT 
1 2 7 $ : 



MOVB U.UNIT(R5) ,R2 



15.2 DATA COLLECTION 



15.2.1 Storage Dependencies - 

R 1 = I R P address 
R5=UCB address 



15.2.2 Record Format 



Hook I.D. 



Ti mes tamp 



Taskname (RAD50) 



TI UCB Address 



IRP Address 



12 



14 



15.2.3 Record Length 
14. bytes . 
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16.0 H$I0DN - I/O DONE PROCESSING 



16.1 LOCATION 



I OSUB . MAC 

Follow $IODON::MOV 



U.SCB(R5) ,R4 



16.2 DATA COLLECTION 

16.2.1 Storage Dependencies 
R4= SCB Address 

16.2.2 Record Format - 



Hook I.D. 



Ti mestamp 



Taskname ( RAD 50 ) 



TI UCB Address 



IRP Address 




2 



12 
14 



16.2.3 Record Length 
14. bytes. 
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17.0 H $ I OF N - COMPLETE I/O POST PROCESSING 



17.1 LOCATION 



I OSUB . MAC 

Follow $ I OF I N 



17.2 DATA COLLECTION 

17.2.1 Storage Dependencies 
R3=IRP address 

17.2.2 Record Format - 



Hook I.D. 



Ti mes t amp 



Taskname (RAD50) 



TI UCB Address 



IRP Address 




2 

6 

12 
14 



17.2.3 Record Length 
1 4 . bytes . 
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18.0 H$QAC1 - QUEUE I/O PACKET TO AC P 



18.1 LOCATION 

DRQ I . MAC 

After $ D R Q I : : 
After FCXIT: 

Fol low MOV U.ACP(R5) ,RO 

18.2 DATA COLLECTION 

18.2.1 Storage Dependencies - 
R 1 = I R P address 

18.2.2 Record Format - 



Hook I.D 



Ti mes tamp 



Taskname (RAD50) 



TI UCB Address 



12 



UCB Address 



14 



Functi on Code 



16 



LUN 



IRP Address 



20 
22 



18.2.3 Record Length - 
20. bytes. 
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19.0 H$QAC 2 - QUEUE I/O PACKET TO AC P 



19.1 LOCATION 

IOSUB .MAC 

After $GTPKT 
Fol 1 ow 95$ : 



19.2 DATA COLLECTION 

19.2.1 Storage Dependencies 
R1=IRP address 

19.2.2 Record Format - 



Hook I.D 



Timestamp 



Taskname ( R AD 50 ) 



TI UCB Address 



UCB Address 



Function Code 



LUN 



IRP Address 



12 
14 
16 

20 
22 



19.2.3 Record Length 
20. bytes. 
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20.0 H$GACP - ACP GETS AN I/O PACKET 



20.1 LOCATION 



FIOSUB.MAC (F11ACP) 

After .GTPKT:: 
Fol 1 ow 10$ : MOV 



Rl ,. IOPKT 



20.2 DATA COLLECTION 

20.2.1 Storage Dependencies 
Rl= I RP Address 

20.2.2 Record Format - 



Hook I.D. 



Ti mestamp 



Taskname ( RAD 50 ) 



TI UCB Address 



IRP Address 





2 



12 
14 



20.2.3 Record Length 
14. bytes 
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21.0 H$0 VL Y - LOAD OVERLAY FROM DISK 



21.1 LOCATION 



DRQ I .MAC 

After 
After 
Follow 



$DRQIO : : 
10$ : 



BNE 



IEOVR 



21.2 DATA COLLECTION 

21.2.1 Storage Dependencies - 

R4=<Address+2> of Overlay Relative Block Number 

21.2.2 Record Format - 



Hook I.D. 



Ti mes tamp 



Taskname ( R AD 50 ) 



TI UCB Address 



Rel ati ve Bl ock Number 




2 



12 



14 



21.2.3 Record Length 
14. bytes 
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22.0 H$S YE N - SYSTEM ENTRANCE 



22.1 LOCATION 



SYSXT.MAC 

After $D IRSV 
Follow 

SYSXT.MAC 

After $INTSV 
Follow 

SYSXT.MAC 

After $ I NTSC 
Follow 



MOV SP,@$HEADR 



MOV SP,@$HEADR 



MOV SP,@$HEADR 



22.2 DATA COLLECTION 

22.2.1 Storage Dependencies - 
None 

22.2.2 Routine - 

Timestamps system entrance time $BSTIM. 



22.2.3 Record Format - 
None 
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23.0 H$SYXT - SYSTEM EXITS TO USER TASK 

23.1 LOCATION 

SYSXT.MAC 

After $DIRXT:: 
Follow 5 $ : 

23.1.1 Storage Dependencies - 
None 

2 3.1.2 Routine - 

/ 

Copies current clock time, subtracts system entrance 
time ($BSTIM) , and adds the resulting delta time to 
the total system time $TSTIM. 

23.1.3 Record Format - 
None 

( 
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24.0 H $ E I D L - ENTER EXECUTIVE IDLE LOOP 



24.1 LOCATION 

SYSXT.MAC 

After 
After 
Follow 



RESCH : 
30$ : 



BNE 



10$ 



24.2 DATA COLLECTION 

24.2.1 Storage Dependencies - 
None 



24.2.2 Routine - 

Copies current clock time, subtracts the system 
entrance time ($BSTIM), and adds the resulting delta 
time to the total system time $TSTIM. Timestamps idle 
entrance time $BIDLE. 



24.2.3 Record Format 
None 
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25.0 H$ X I D L - EXIT EXECUTIVE IDLE LOOP 



25.1 LOCATION 

SYSXT.MAC 

After RESCH 
Follow 46$ : 



CLRB 



SYSXT.MAC 

After $FORKO:: 
Follow BCC 



(Rl) 



$ I NTXT 



25.2 DATA COLLECTION 

25.2.1 Storage Dependencies - 
None 



25.2.2 Routine - 

Copies current clock time, subtracts the idle loop 
entrance time ($BIDLE), and adds the resulting delta 
time to the total idle time $IDLE. Timestamps system 
entrance time $BSTIM. 



25.2.3 Record Format - 
None 
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H$U SER - USER INFORMATION HOOK 

LOCATION 

QPDR V . MAC 

Fol 1 ow QPINI : 

DATA COLLECTION 

Storage Dependencies - 

R1=IRP address 
R5=UCB address 



HOOK RECORD DEFINITIONS 



26.2.2 Record Format - 



Hook I.D. 



Timestamp 



Taskname ( RAD 50 ) 



TI UCB Address 



Function Code 



LUN 



QIO Parameter 1 



QIO Parameter 2 



QIO Parameter 3 



QIO Parameter 4 



QIO Parameter 5 



QIO Parameter 6 



12 
14 
16 
20 
22 
24 
26 
30 
32 



26.2.3 Record Length 
28. bytes. 
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Appendix B 



MPB DEFINITIONS 



Monitor Parameter Block 



The Monitor Parameter Block (MPB) is the data structure which 
contains the measurement parameters. These measurement 

parameters are defined by invoking the procedure (PSMPGEN.CMD, 
which produces: 

o The binary MPB file ( f i 1 ename . MPB ) , 

o The source MPB file ( f i 1 en ame . PAR ) , and 

o The MPB saved answer file (filename.CMD). 

The COL task reads the MPB and initializes its databases from 
the MPB. 

The length of an MPB in bytes is M.LGTH (defined by MPBDF$ in 
HKMAC . MAC ) . 

The MPB has the following format and contents: 



Parameter 

MPB ID word ( I$MPB) 
Measurement label 
Buffer Type 
Buffer Count 
Buffer Size (bytes) 
Buffer Size (64b blk) 



Offset 

M.PID 

M.LABL 

M.BTYP 

M.BCNT 

M.BSI2 

M.BS64 



Si ze ( wds ) 
1 

32. 
1 
1 
1 
1 



Values 



I$MPB 



D Y NAM IC = 
STATIC=1 
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Pa ramet e r 

Buffer Partition Name 
SYS Partition Name 

Buffer Partition Ad dr. 

Buffer Partition Size 

Buffer Partition Flags 
Measurement Mode 

Sample Count (Buffers) 
Sample Interval Mag. 
Sample Interval Units 
Repeat Count 
Repeat Interval Mag. 
Repeat Interval Units 
Hook Bit Table 
I/O Selection Word 
Other Devi ces Sel . Word 
Device Class Mask 
Device Selection Mask 
Sys . Metri cs Samp . Int . 
Sys . Metrics Partition 
Sys. Me tries Device 
T I Filter Device 
TI Filter Device Num. 
MPB Validation Word 
Task Selection Mask 
Task Sel ecti on Tabl e 



Offset 
M.BPAR 
M.BPNM 
M.BPAD 
M.BTSZ 
M.BFLG 
M . MODE 

M.SCNT 

M.SINT 

M.SUNT 

M.RCNT 

M.RINT 

M.RUNT 

M.HTBL 

M . I OS 

M.OTHR 

M.CW1M 

M.CW1S 

M.SAMP 

M . PART 

M.DEVC 

M.TIDV 

M.TINM 

M. VALD 

M.TKS 

M.TTBL 



Si ze ( wds ) 
2 
2 



Values 



MANUAL=0 
AUTOSTOP 
REPEAT=2 



P$$VER 



28, 
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Appendix C 

INFORMATION RECORD 
DEFINITIONS 



Information Records 

The Information Records provide system context data which can 
be correl ated with the Hook Records to identify tasks , 
partitions, and 1/0 device-units. 

In addition , there are Inf ormati on Records which capture 
essential data when COL starts and stops data collection. 

For lengths of the f ol 1 owi ng records , see the macro IBDE F$ in 
H KM AC . MAC . 

I $ S Y S - System Common Information 



I $ S YS 



Initial Pool Size 



$FMASK 




2 
4 



$FMASK+2 6 



$FMASK+4 10 



SHFMSK 12 



Sys. Met. Dev. UCB Address 14 
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I $TC B - Task Control Block 



I$TCB 

m 

I$TCB Record Size 2 

TCB Address 4 

TCB Contents 6 



I $ PC B - Partition Control Block 
I$PCB 

I $ PC B Record Size 
PCB Address 
PCB Contents 

* 

» 
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I $ DC B - 



Devi ce Control Block 



I$DCB 

I$DCB Record Size 



DC B Address 



DC B Contents 



I $ UC B - Unit Control Block 



I$UCB 



I $UC B Record Size 




2 



UCB Address 



UCB Contents 
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I$CKP - 



Checkpoint File Information 



i 



I$CKP 



CKP. File Device UCB Addr. 



CKP. File Size 



I$TMR - Start Data Collection 



I$TMR 





System Time 


(Year) 


2 


System Time 


(Month) 


4 


System Time 


(Day) 


6 


System Ti me 


(Hour) 


10 


System Time 


(Minute) 


12 


System Time 


(Second ) 


14 


System Time 


(Tick) 


16 


Ticks Per Second 


20 


High KWll-P 


Time 


22 


Low KWll-P Time 


24 
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I$STM - Stop Data Collection 



I$STM 


n 
u 


System Time i 


Year) 


iL 


oy stem i i me ( 


month j 


A 
H 


System Time ( 


Day) 


a 

D 


Sys tern Time ( 


Hour) 


i n 
i U 


System Time ( 


Minute) 


1 


System Time ( 


Secon d ) 


1 A 


System Time ( 


Tick) 


1 f\ 
1 D 


Ticks Per Second 


9 n 
c u 


High KWll-P Time 


9 9 


Low KWll-P Time 


C H 


CPU Kernel Time (High) 


9 f. 
L O 


CPU Kernel Time (Low) 




CPU Idle Time 


(High) 


"3 9 
■J c 


CPU Idle Time 


( Low ) 




Device Usage 


Time (High) 


36 


Device Usage 


Time (Low) 


40 
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Appendix D 



SYSTEM METRICS RECORD 

DEFINITIONS 



System Metrics Record 



The System Metrics Record contai 
system-wide usage of the CPU 
partition , checkpoi nt file space, 

The length of the S$MET record , 
defined by S M D E F $ in H KM AC . MAC . 



ns data which represents the 
, pool , a sel ected memory 
and a sel ected device. 

in bytes , is S$METL which is 
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S$MET 



High KW11-P Time 



Low KW11-P Time 



CPU Kernel Time (High) 



CPU Kernel Time (Low) 



10 



CPU Idle Time (High) 



12 



CPU Idle Time (Low) 



14 



# Free Pool Nodes 



16 



Total Free Pool Space (bytes' 



20 



Smallest Pool Node (bytes) 



22 



Largest Pool Node (bytes) 



24 



Main Partition PCB Address 



26 



Number of Subpartitions 



30 



Total Space Used (32W blks) 



32 



Total CKP. Fi 1 e Space 



34 



Total CKP. File Space Used 



36 



UCB Address of Device 40 



Device Usage Time (High) 



42 



Device Usage Time (Low) 



44 



Free Disk Blocks (High) 



46 



Free Disk Blocks (Low) 



50 
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Appendix E 

LOGFILE FORMAT 



1.0 DISK LOGFILE FORMAT 

A logfile on disk is a F i 1 e s - 1 1 file with the following format 



VBN 
1 

N 

N+l 

2N 



M*N 



BUFFER 
#1 



BUFFER 

#2 



BUFFER 
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Each BUFFER has the following general 
offsets): 



format (byte 



Record Count 



Overflow Count 



x $xxx 



x$xxx 




x$xxx is 1$ , H$ or 
S$ record I D . 
See appendices 
A , B , C and D . 
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All BUFFERS are the same length. The BUFFER size in 512B 
blocks is derived from the BUFFER size in bytes which is 
stored in the MPB in BUFFER #1: 

BUFFER #1 Format (byte offsets) 



Record Count 



Overflow Count 



I$MPB 



BUFFER Size (bytes) 



I$SYS 



Note : 

I $M PB is the 1st record; 

I $ S YS is the 2nd record; 

x$xxx is 1$ , H$ or S$ 
record ID . 
See appendices 
A , B , C and D . 



4+M.BSIZ 



x$xxx 



Unused Space // / 

Y//////////A 



BUFFER size (blocks) = BUFFER size (bytes) 

1 L • 
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2.0 MAGTAPE LOGFILE FORMAT 



A magtape can contain one or more logfiles. Each BUFFER 
terminated by an IRG. Each logfile is terminated by a ta 
mark (EOF). The magtape is terminated by a double tape ma 
(EOF EOF). Each BUFFER has the same format as for disk. 



BUFFER 
#1 



BUFFER 
#M1 




end of logfile #1 



BUFFER 
#1 



BUFFER 
#Mn 



EOF 
EOF 



end of logfile # n 
end of tape 
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3.0 FCS LOGFILE FORMAT 



The CLF utility task can be used to convert a logfile from the 
formats specified in section 1.0 and 2.0 to a file containing a 
stream of variable length FCS records. Each FCS record 
contains one record of type H$xxxx, I$xxxx or S$xxxx. The 
first word of each record contains the record ID, H $ x x x x , 
I$xxxx or S$xxxx. The record formats are specified in 
Appendices A, B, C and D. 

See Chapter 3, Section 3.2.5 for using CLF. 
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PERFORMANCE REPORT 
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Appendix G 

EXAMPLE SMPGEN 



a s n dro:=sy: 

SET /UIC=Cil t21 



0SMPGEN 

; % % % Software Monitor Parameter GENeration command file *** 
Version 2 *** 

?Copyri3ht (C) 1981 Digital Eouipment Corporation* Maynard* Mass. 

V 
f 

i Initialize default parameters 

* READ SAVED ANSWER FILE FOR DEFAULT ANSWERS? CY/N3J 
t 

i Select parameter category* type <esc> for help 

* ENTER PARAMETER CATEGORY C S ] J 

*f LEGAL PARAMETER CATEGORIES ARE I 

% HOOK TASK MODE LABEL 

\ BUFFER DEVICE SYSTEM DONE 

* ENTER PARAMETER CATEGORY CS]? HOOK 
i Select/deselect hook points 

? 

* CPU USAGE HOOKS? CY/NU Y 

* MEMORY USAGE HOOKS? C Y/N] J Y 

* I/O DEVICE USAGE HOOKS? CY/N3S Y 

* USER INFORMATION HOOK? CY/N]J Y 

* LOAD OVERLAY HOOK? C Y/N] t N 

* CALL DIRECTIVE PROCESSOR HOOK? C Y / N ] t N 
r 

j Select parameter category? type <esc> for help 

* ENTER PARAMETER CATEGORY [Sit BUFFER 

r 

; Setup buffer management parameter? type <esc> for help 



* ENTER BUFFER TYPE CD J DYNAMIC] CS R50-7K 

* ENTER NAME OF BUFFER MAIN (SYS) PARTITION CD J GEN] CS R50-6K BUFPAR 

* ENTER NAME OF BUFFER COMMON/REGION CD J TRCPAR] CS RJ0-61J 

* ENTER NUMBER OF BUFFERS CD R12.-8. DJ2.3J 4 

* ENTER BUFFER SIZE IN 512B BLOCKS CD RJ1.-16. D 5 8 « ] J 

i Select parameter category? type <esc> for help 

* ENTER PARAMETER CATEGORY CS] J MODE & 

f Define data collection mode? type <esc> for help 

■ 5 

•* ENTER MODE CD 5 MANUAL] CS RJO.-S.]! 

( 

1/82 EXAMPLE SMPGEN G-1 



>i Select parameter cateaoryj type <esc> for help 
'■ ' f 

>* ENTER PARAMETER CATEGORY CSK TASK 

> f 

> t Select/deselect tasks to be traced 

>* DO YOU WANT TO TRACE ALL TASKS? CY/N] I 

>* DO YOU WANT TO SPECIFY THE TASKS NOT TO TRACE? CY/N] : Y 
>i Enter one taskname per line. Terminate list by <CR>. 
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v Select parameter category* type < esc > for help 

' r 

* ENTER PARAMETER CATEGORY CS] J DEVICE 

* DO YOU WANT TO COLLECT DATA FOR ALL DEVICES? CY/N3I 
» 

t Select device types to be traced 

* TRACE DISK (DIRECTORY DEVICE) I/O ACTIVITY? CY/N] : Y 

* TRACE TAPE (SEQUENTIAL DEVICE) I/O ACTIVITY? CY/N] t 

* TRACE TERMINAL I/O ACTIVITY? CY/N] : 

* TRACE ALL OTHER DEVICES I/O ACTIVITY? CY/N] J 

f Select parameter category » type < esc > for help 

? 

* ENTER PARAMETER CATEGORY CS] : SYSTEM 
i 

i Select system metrics 

* DO YOU WANT THE SYSTEM-WIDE METRICS? CY/N] t Y 

* ENTER SYSTEM METRICS SAMPLING INTERVAL (SECS) CD RJ 15.-28800, DJ60.DJ 120 
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>i Select parameter category! type <esc> for help 

>* ENTER PARAMETER CATEGORY CS3 5 LABEL 

> f 

:■? Define 1 to 63 character label string type <esc> for help 
:-* ENTER MF'B LABEL CS R 5 - 6 3 3 5 This is 3 Sample SMPGEN . 
>r Select parameter category* type < esc > for help 
>* ENTER PARAMETER CATEGORY C 3 □ I DONE 

>i Write saved answer file and parameter source file 
>r Enter <esc> if no output file is desired 

>'* ENTER NAME OF SAVED ANSWER FILE CD JTRACE.CMD 3 C S 3 J SAMPLE, CMD 
>* ENTER NAME OF PARAMETER SOURCE FILE L D I TRACE . PAR3 LSI I SAMPLE. PAR 
>MAC SAMPLE=HKMAC , SAMPLE , PAR 
: TKB 5PARBLD 

>PIP SAMPLE . OBJ r */DE , PARBLD . CMD ? * 

:>e <eof> 



>C0L SAMPLE-SAMPLE 

COL -- PERFORMANCE MONITOR INITIALIZED 
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EXAMPLE INSTALLATION 



>asn dro:=sy: 
>set /uic*cu.23 

>UFD SYJC11.23 

>FLX = MM:C11. 23PM0NCPY.CMD 

>(?PMONCPY 

>* IS SOURCE DEVICE A MAGTAPE? CY/N3: Y 

>* IS DESTINATION DEVICE A MAGTAPE? C Y/N 3 ! N 

>* ENTER SOURCE DEVICE (DUN!) CS3 J MM J a 
>* ENTER DESTINATION DEVICE ( D D N J ) [S3 J DROJ 
>* IS DRO! MOUNTED? C Y/N 3 ! Y 

!> i 

>i PLEASE SPECIFY THE GROUP AND MEMBER NUMBERS OF THE SOURCE KIT DIRECTORY. 
>) THE ORIGINAL KIT DISTRIBUTION IS IN DIRECTORY C11.23. 

>* ENTER GROUP NUMBER OF SOURCE KIT DIRECTORY CO R ! 1-377 DM 13: 
. * ENTER MEMBER NUMBER OF SOURCE KIT DIRECTORY CO R! 1-377 D ! 2 3 ! 

>i PLEASE SPECIFY THE GROUP AND MEMBER NUMBERS OF THE DIRECTORY TO WHICH 
i THE SPM-UM KIT FILES WILL BE COPIED. 

> f 

>* ENTER GROUP NUMBER OF TARGET DIRECTORY CO R: 1-3773 : 11 

* ENTER MEMBER NUMBER OF TARGET DIRECTORY CO R5 1-3773 ! 2 

SET /UIC=C11.23 
>FLX DRO:/RS=MM! CU .23SMPGEN.CMD. SPM. DOC/DO 
>FLX DRO:/RS/-RU=MM! Cll >23HKMAC.MAC.PMONSLP.CMD/DO/-RW 
>FLX DRO:/RS/-RW=MM:CU.23DRDSP.COR.DREIF.COR.SYSXT.COR/DO/-RW 
>FLX DRO!/RS/-RU=MMS CU.23DREXP.COR. DRQIO.COR. I OSUB. cor/do/- ru 
>flx dro:/rs/-rw=mm: C 1 1 . 2 3LOWCR. COR.SYSCM.COR/DO/-RU 
>FLX DRO:/RS/-RW=MM! Cll »23REQSB.CORiLOADR.COR/DO/-RU 

>FLX dro:/rs/-ru=mm:ch»23drsub.cor/do/-ru { 

>FLX DRO :/RS/-RU = MM! CI 1 .23PMONPAT.CMD. fiosub. pat/do/ -rw 

•flx dro:/rs/-rw=mm;cu»23col.olb.colbld.odl»pmonbld.cmd/do/-rw 
>flx dro:/co/rs/bl:60./-ru=mm: cu > 23Clf.tsk/do/-rw 

; FLX DR0:/C0/RS/BL!75./-RU=MM;c11i230VL.TSK/D0/-RW 

>FLX DROI/CO/RS/BL! 175./-RW=MM! CU .23DRS. TSK/DO/-RW 

!: FLX DRO ! /RS/-RU=MM ! C 1 1 » 23CLF . MAP . DRS . CMD . MDRTKB . CMD/DO/-RU 

> FLX dro:/rs/-rw=mm:cii»230vl.map.ovl.olb/do/-rw 

>FLX DRO ! /RS/-RW=MM ! C 1 1 » 23MDREIS . OLB . MDRFPP . OLD . DRS . MAP/DO/-RU 
>* APPLY CORRECTIONS TO EXECUTIVE SOURCES? C Y/N i ! Y 
>ASN SY!=SR5 

>* IS THIS AN RL01/RL02 SYSTEM GENERATION? CY/NU 
.SET /UIC = CU.103 

>PIP SR .' RSXMCO . MAC/AP = C U » 23HKMAC . MAC 

>SLP 6CU .23DRDSP.COR 

>SLP BClli 23REQSB.C0R 

>SLP eCll.23SYSXT.CHR 

>SLP eCU.23DREIF.COR 

>SLP eCU.23DREXP.COR 

>SLP eCU.23LOADR.COR 

>SLP eCll .23DROIO.COR 

>SLP eCll.23I0SUB.C0R 

>SLP eCU.23SYSCM.C0R 

>SLP etU.23LOUCR.COR 

>SLP eCU.23DRSUB.C0R 

>* APPLY PATCH TO FUACP DISPATCHER MODULE (FIOSUB)? CY/N3 : Y 

MNS $PAT i> 
>SET /UIC=CU.23 

>MAC FIOSUB. POB=HKMAC. MAC. FIOSUB. PAT 
>LBR FIOSUB. OB J. 1 = SR! C 1 » 24 3FCP/EX ! FIOSUB 

>PAT FIOSUB. OBJ )2«»FI0SUB. OB J U/CS 1073710. FIOSUB. POB/CS 1016023 
>* WAS THE CHECKSUM SUCCESSFUL? C Y/N 3 ! Y 

( 
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.SET /UIC=C1.243 

>LBR SR!FCP/RP = CU.23FIOSUB.OBJi 2 
Module 'FIC-SUB' replaced 

•REM . . .PAT 

>ASN =SRJ 

>SET /UIC=C11» 23 

>e <EOF> 

PIP MDREIS.OLBf */BE 

: SET /UIC=C200f 2003 
>@SYSGEN 

> f 

>) RSX-11M V4.0 BL32 System Generation PHASE I -- version 1.53 

F 

>i 21-JAN-82 10158:08 

>i Bia disk distribution kit 

!> r 

>* 3. Do you want to inhibit execution of MCR commands? CY/N3J 

>* 4. Have you made a copy of the distribution kit? CY/N35 Y 

>* 5. Are you aeneratina a mapped system? CY/N3J Y 

>* 7. Use an input saved answer file? CY/N3J Y 

>* 3. Name of input saved answer file ZBi S YSSAVEP . CMD3 CS3 5 

>i Phase I input saved answers 

>'f created on 19-JAN-82 at 09 ! 45 ! 53 

>» by SYSGEN version 1.53 

>i are from file DRO i 1 200 » 200 3 S YSSA VED . CMD i 2 

>* 10. Name of output saved answer file CD5 DRO ! 1 200 f 200 3 S YSSAVED . CMD3 [S3: 
f 

>f Phase I output saved answers created in file IiR0:C200i200 3SYSSAVEP.CHD;3 

> r 

>* 11. Use saved host configuration? CY/N3 5 Y 

* 12. Use saved peripheral configuration? CY/N35 Y 
>* 13. Skip end of section (EOS) breakpoints? CY/N3! Y 
>* 14. Skip end of execution CE0X) breakpoints? CY/N35 Y 
>* 15. Clean up files from previous GENs? C Y/N3 : Y 
>* 16. Chain to Phase II after Phase I completes? ZY /HI i Y 

5 

: SET /UIC=C1 ,13 
: PIP CI f20 3RSXBLD.CMD M/DE/NM 
: PIP C 1 > 24 3RSXBLD.CMD J */DE/NMf TTBRVBLDJ* 
■PIP C1f503SYSv'MR.CMDf*/DE/NMfC1f543SYSv'MRf* 
>PIP CI 1 f 203*. 0B J f */BE/NM»*.UBC;*f *. ICR i * t * . I DS J * » * . PCS f * 
•PIP CI 1? 24 3*.OBJ}*/DE/NM,*.UDC! *f*. ICR > * , * . I BS i * f * . TTY i * , * . PCS i * 
>PIP [11.303*.LSTf*/DE/NMrC11.343*.LST>* 

: PIP C U,103RSXMC. MAC !*/DE/NM»ICTABi*. C200.2003SGNPARM.CMD;* 

PIP C200,200 3RSXBLD.CMD>*/DE/NM,TTDRVBLD;* 
>PIP SY! Cll f203RSXASM.CMD i */DE/NM f RSXDRVASH f * f C 1 2 f 203MCRSETASM 5 * 
>PIP SYSCll f 24 3RSXASM.CMIU */DE/NM » RSXBRVASM f *» C 1 2 » 24 3MCRSETASM ? * 

>PIP /FR 

DRO ' has 86205. blocks free > 45475. blocks used out of 131680. 
Largest contiguous space = 55911. blocks 

6648 . file headers are free f 1451 . headers used out of 8099 . 
>SET /UIC = CUf103 

> F 

>f Target configuration 
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; Processor.' S 1/70 Memory S i :e ! 320K » Hepped System ! RSX- 1 1 M 

i Sv/itch Register 

f Floating Point Processor 

; Extended Instruction Set 

i Parity Memory 

i Cache Memory 

r 

f Host conf j suration ^ 

r 

i Executive options 

i 

i Terminal Driver options 
r 

i System Options 
? 

i 

i Think ins . . . 

; ('-' 
i End of Executive option generation at 11501 J13 on 21-JAN-32 

i 

i Peripheral configuration 

! Parameters appearing in sauare brackets 'C...3* can only be 

i specified for the first controller of s particular device, 

i Parameters appearing in parentheses '(,..?' only need be specified 

} if the indicated option is present on the tarsSet system. 

; The default for loadable drivers has beer, set to *TRUE*. 

; To override this setting enter R (resident) as the first parameter 

; f 0P the first controller of the specified device. 

? 

i A/D and Laboratory devices! None specified 

; Interprocessor communication devices! None specified 

r 

i Unit record devices! None specified 
i 

i Disks ! DR 
f 

i Tapes! MM 

i Non-physical ( pseudo ) devices! CO? NL> TI» CL > LB > SY 
• i Terminal interface devices! Y I ? Y Z 



• SET /UIC»C1 » 243 ! Creating TTDRVPLD . ChU 
SET /UIC=tll>10] 

■■■> End of interrupt vector area has been set to 400 

> i 

■- i Create Executive build files 

> r 

>PIP RSXMC.MAC=SY!RSXMCO.MAC/AP 
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>asn sy:=lb: 

>f Start of Executive assembly at li!04!37 on 21-JAN-82 

> f 

: SET /UIC=C11 -241 
>HAC (?S Y ! RSXASM 

>i End of Executive assembly at 11524:31 on 21-JAN-82 

r 

> ? 

>i Start of- NCR (subset) assembly at 11!24S31 or. 21-JAN-82 

set /ijic = c12,24d 
: mac (?sy ; hcrsetasm 

>) End of MCR (subset) assembly at 11 :27I02 on 21- JAN-82 



>> Start of device drivers assembly at 1 1 ! 27 : 03 on 21-JAN-82 

> r 

>SET /UIC=C11 >24] 
: MAC 9SY ! RSXDRVAfM 
y 1 

>f End of Device drivers assembly at 11:36154 on 21- JAN-82 

>ASN -Lhi 

>t Prepare for task building 
? 

>SET /UIC=C1 ,243 
: PIP RSXllM.0BS = r.ll»24 3*.0BJ 
:: PIP TTDRV.0BJ = C11»24 3*.TTY 
>LBR RSX11M/CR: 100. I960. ! 1 23 . =RSX 1 1 M , OBS 
>LBR TTDRV/CR!30. ; 256 , ! 64 . =TTURV 
: PIP /NV=C11 j 103RSXBLD.CMD 
>PIP Ell 1 103RSXBLD. CMDf */HE/t'H 
r 

':■■} Clean-up extraneous object files 

>PIP RSXUM.OBSJ*/BE/NMf TTORV.OBJf *, Cll > 24 3* . OB J i * , * . TTY ? * 

y r 

r 

>i End of SYSGEN phase I at 1 1 : 39 ! 52 on 21-JAN-32 
>i — Chaining to C 200 , 200 3 S YSGEN2 . CMD 

r 

>SET /UIC=C200»2003 
i 

>i RSX-11M V4.0 BL32 System Generation Phase II -- version 1.50 

> r 

>'r 21-JAN-82 li:39!54 



>} Bis disk distribution kit SYSGEN version 1.53 for RSX-11M BL32 

y ? 

>i Continuation from SYSGEN PHASE I done on 21-JAN-82 at 11:39} 48 



>» Phase 1 1 input saved answers 

>! created on 19- JAN-82 at 11:13135 

>i by SYSGEN version 1 .50 

>» are from file DR0 : C 200 > 200 1 S YSS A VED . CMD i 2 
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>i Phase II output saved answers created in file DRO J C200 r 2003SYSSAVED . CMD ! 3 

>asn sy:=lb: 

>PIP /FR 

DRO I has 79853. blocks freer 51827. blocks used out of 131680. 
Largest cont isuous space = 55911. blocks 

6550. file headers are freer 1549. headers used out of 8099 . 

y i 

> i Start of library build at 11 MOI 17 on 21- JAN-82 

)• r 

>SET /uic=ci»n 

>pip lb!anslib.olb/nv=lb!syslib.olb 
>lbr lbjanslib/rp=sy:fcsmta 

Module •ANSPAD* replaced 

Module " ASSLUN" replaced 

Module "BIGBUF" replaced 

Module "CLOSE ' replaced 

Module ' CONTRL " replaced 

Module "CREATE* replaced 

Module "DIRECT" replaced 

Module "FCSTYP" replaced 

Module "GET " replaced 

Module " GETSC1 ' replaced 

Module ' OPEN ' replaced 

Module " OPENR " replaced 

Module "OPFID ' replaced 

Module " OPFNB ■ replaced 

Module " PARSFN " replaced 

Module "POINT ■ replaced 

Module " PUT " replaced 

Module "PUTSQ " replaced 

Module * RDUAIT * replaced 

Module "RETAUR" replaced 

Module " RSTFDB " replaced 

Module * RUBLK " replaced 

Module " RULONG " replaced 

Module " WATSET * replaced 

Module •WTUAIT" replaced 

Module " WTUATD * replaced 
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: SET /UIC=C1»24D 

> PIP SY:MCR.0BJ/NvVNM=C12f 243*. OBJ 

>lbr sy:mcr/rp=sy:mcr.obj 

Module , Iiy20V * replaced 
Module "SPSOV ' replaced 
Module "STSUB ■ replaced 
Module "SXlOy ' replaced 
Module 1 SX20V " replaced 
Module "SX30U • replaced 
Module 'SX40y ■ replaced 
>PIP SY : C12»24]*.0BJJ*/DF/f.'M 

>i End of 1 ibrara build at 1 1 ! 46 ! 16 on 21-JAN-82 



>i Start of Executive task build at Il!46:i7 or. 21-JAN-82 

: PIP Clr343*.*!*/DE/NM 
>TKB @LB .' RSXBLD 

> ? 

>; End of Executive task build at 11 !48!16 or. 21-JAN-82 

> V 

!> r 

>i Start of system in.s3e creation at 1 1 ? 48 1 1 6 on 21-JAN-82 

> r 

>SET /UIC=C1»543 

>PIP RSX11M.SYS/C0/NV/BI_:498.=RSX11M.TSK 

> j End of system imaae creation st 1 1 ! 48 J 20 on 21- JAN-82 



>j Start of full duplex terminal driver t3sk build at 11:48:20 on 21-JAN-32 

.'> r 

: SET /UIC=C1»243 

:>tkb @lb:ttdrmbld 

>} End of full duplex terminal driver task build at 11:48147 on 21-JAN-32 



>f Start of loadable driver task build at 11:48:47 on 21-JAN-82 

>TKB 0S Y ! CODRy BLD 
>TKB (?S Y ! DRDRUBLD 
>TKB eSYIMMDRVBLD 

> r 

>> End of loadable driver task build at 11149:31 on 21-JAN-82 

> i 
>i 

>i Start of Connor, block task build at 1 1 : 49! 32 on 21-JAN-82 

'.> ? 

>i Build the ANSL I B flavor of the PCS resident library common 

> f 

y ? 

>i Creating the task build . CMD and . DDL files in SYiCl.243 

> 5 

>TKB (?SY: CI f24DFCSRS1BLD.CMD 

> i 

>'? End of common block task build st 1 1 : SO ! 43 or. 21-JAN-82 
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Start of privileged task build at 11 !S0!43 or, 21-JAN-82 



Note that the following tasks will be built for your system! 



BOO 
PUT 
LPP 
UNL 
BRO 



DMO 
MCR 



F11MSG 
PMH 

SHUTUP 



RMB 
ACS 



COT 
DCL 



MTAACP 



ERRL06 



MOU 

say 

SHF 



FCPMDL 



ICP 

QMG 

TKTN 

ACNT 

ELI 



UFD 
BYE 



INI 

QMGCLI 



LOA 
HEL 



INS 

QMGPRT 



It is assumed that C 1 » 1 3FCSRES . STB is an ANSLIB version of the FCS 
resident library 



>» Creating the task build .CMC and . ODL files in SY ! C 1 . 243 

: TKB SSYSCIf 24 3B00BLB.CMD 
>TKB 8SYJC1 f243DM0BLD.CMD 
> TKB eSYJC1.243COTRESBLD.CMD 
: TKB @S Y ! C 1 1 243FCPMDLBLD . ChD 
: TKB BSY: CI f243ICPBLD.CMD 
> TKB @SY!C1. 243INIBLD.CMD 
> TKB @SY:Clr243INSBLD.CMD 
> TKB 8SYJC1f243PMTBLD.CMD 
> TKB 0SYJClf243HCHBLD.CMD 
> TKB eSY5Clf243DCLBLD.CMD 

TKB 0SY5Clf243MOUBLD.CMD 
> TKB 8 S Y ! CI f 2 4 3 G MG R E S B L D . C i D 

TKB 0SY! CI f24 3GCLRESBLIi.CMD 
>TKB 8SY: CI f243GPRBLD.CMD 
> TKB 0SY! CI f243LPPRESBLD.CMD 
>TKB 0SY ! C 1 f 24 3F1 lMSGBLD . CMD 
: TKB eSY5ClF243MTABLD.CMD 

TKB 0SY:C1f243SAUBLD.CMD 

TKB 8SYJC1f243TKNBLD.CMD 
: TKB 8SYJC1f243UFDBLD.CMD 
> TKB 8SY:C1f243L0ABLD.CMB 
:: TKB 8SY J CI f243UNLRESBLB.CMD 
.: TKB 8SYi C1f243PMDRESBLD.CMD 
> TKB eSYJ CI F243RMriBLD.CMD 
> TKB 8SY! CI f 243SHFBLD.CMD 
>TKB 0SY! C 1 . 24 3ACNRESBLD.CMD 
-TKB 8SY! CI j243BYEBLD.CMD 
> TKB 8SY:C1f243HEL.RESBLD.OiB . 
> TKB eSY! CI f243BR0BLD.CMD 
: TKB BSYICl. 243SHUBLD.CMD 
> TKB 9SY! C1f24 3ACSRESBLD.CMD 
> TKB 8SY!C1f243ERLBLD.CMD 
>TKB 8SYJC1f243ELIRESBLD.CMD 



>i End of privileged task build at 12131 !43 on 21-JAN-82 




.> F 

>asn sy:=lb: 
>vmr 8sysvmr 

MMR — #DIAG*-Partition reduced to executive co»mon size 
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INS EXC0M1 

VMR -- *DIAG*-F'3rtition reduced to executive common size 
INS EXCOi 2 

VMR — *DIAG*-Loadable driver Isrser than 4K 
LOA TTJ 

VMR — *DI AG*-Ir.stal led tasks mas no lonser fit in partition 

set /top=drvpar:-« 

POOL=1200!9020. !09020. 



EXC0M1 

EXC0M2 

LDRPAR 

TTPAR 

DRVPAR 



SYSPAft 
FCSRES 
FCPPAR 
GEN 
LDR. . . 
TKTN 
, . . RMD 
Fl 1MSG 
MTAACP 
. . . DM0 
MCR . . . 
. . . DCL 
. . .hOU 
. . . MCR 
F11ACP 
ERRLOG 
F'MT , . . 
COT. . . 
PMD. . . 
SHF. . . 
... INS 
, . .SAU 
. . . UFD 
QMG . . . 
P R T . . . 
LPO 
. ACS 
.AT. 
. QUE 
. PR I 
. BOO 
. ELI 
.MAG 
. LOA 
. HEL 
.BYE 
. BRO 
.UNL 
DRO ! 
DR1 J 
MMO ! 

o n a i 
LUVt 

TTOJ 
TT1 ! 
TT2 ! 
TT3 ! 
TT4 5 
TT55 
TT6 ! 
TT7 ! 



117734 

117670 

117624 

117260 

116734 

1 16670 

116570 

116470 

116424 

116360 

116314 

116250 

12. 1? 

04.3 

VI. 05 

V0012 

0013 

23.26 

2 . 02 

00 

2503 
1 . 1 
M0401 
VI .05 
01 .52 
01 .02 
07.2 
5.08 
06 

2.18 

V0412 

1.8 

1.2 

1.10 

01 .02 

02 

1 . 10 

1.10 

06.02 

VI .03 

01 .02 

03.3 

01.0 

04.1 

V04 

3.0 
Loaded 
Loaded 
Loaded 

TO* 
Loaded 
Lo3ded 
Loaded 
Loaded 
Loaded 
Loaded 
Loaded 
Loaded 



00120000 
00134700 
00143600 
00146400 
00206400 
00206400 
00211500 
00216000 
00216200 
00226300 
00260200 
00304200 
117510 
1 1 1564 
115110 
114200 
114064 
114544 
113040 
112724 
112244 
111700 
1 16134 
1 14430 
113404 
116020 
113270 
112014 
113520 
1 12130 
111450 
115704 
115340 
115224 
114774 
113634 
115570 
115454 
114660 
114314 
113750 
113154 
1 12610 
112474 
1 12360 
111334 



00014700 
00006700 
00002600 
00040000 
00007600 
00003100 
00004300 
00000200 
00010100 
00031700 
00024000 
02073600 



LDRPAR 
SYSPAR 
GEN 
GEN 
GEN 
GEN 

SYSPAR 
GEN 
GEN 
GEN 

FCPPAR 
GEN 
GEN 
GEN 
GEN 

SYSPAR 
GEN 
GEN 
GEN 
GEN 
GEN 
GEN 
GEN 
GEN 
GEN 
GEN 
GEN 
GEN 
GEN 
GEN 
GEN 
GEN 
GEN 
GEN 



248. 
248. 
225. 
200. 
200. 
160. 
160. 
160. 
160. 
160. 
149. 
148. 
148. 
145. 
140. 
105. 
100. 
100. 
100. 

75. 

70. 

70. 

70. 

64 . 

50. 

50. 

50. 

50. 

50. 

50. 

50. 

50. 

50. 

50. 



MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
SUB 
SUB 
SUB 
MAIN 
MAIN 
MAIN 
MAIN 
0000 



COM 

COM 

TASK 

TASK 

SYS 

DRIVER 
DRIVER 
DRIVER 
TASK 
COM 
SYS 
SYS 
2600 



dr: 
mm: 

co: 



00010100 
00027100 
00005600 
00014400 
00014600 
00010100 
00037200 
00037700 
00020000 
00024000 
00040000 
00006300 
00014100 
00016700 
00010100 
00034400 
00033000 
00005700 
00032200 
00001100 
00014000 
00005700 
00060000 
00020600 
00020600 
00021600 
00017700 
00031300 
00032300 
00024100 
00012400 
00030300 
00024400 



lbo: 

LBO ! 

lbo:- 

lbo: 

lbo:- 

lbo: 

lbo:- 

lbo: 

lbo:- 

lbo: 

lbo: • 

lbo:- 

lbo:- 

lbo:- 

lbo:- 

lbo:- 

lbo:- 

lbo: 

lbo : - 

lbo: 

lbo:- 

lbo: 

lbo: • 

lbo:- 

lbo : - 

lbo:- 

lbo : - 

lbo : - 

l b o : - 

lbo:- 

lbo : - 

LBO { - 
LBOJ- 
LBO : - 



00220363 
-00223422 
•00226557 
■00223136 
■00226412 
00221072 
•00221172 
•00225421 
00222730 
00225233 
00224556 
■00131503 
00221150 
00221 1 1 I 
00226530 
•00223460 
00225174 
•00226301 
00223150 
•00223101 
00221215 
•00226204 
00130667 
002247U 
00226002 
00226002 
00221031 
00131547 
00226071 
00226125 
00227021 
00226757 
00227064 
00226363 



FIXED 
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i i io ; 
TT1 1 ! 
j j 3 o • 

T T 1 3 : 
TT14.* 
TT15! 
TT16! 



l o 3 o e ci 
Loaded 
Loaded 
Loaded 
Loaded 
Loaded 
Loaded 



TT1 ? : Loaded 
TT20.' Loaded 
NLOJ 
T 10 I 

clo: tto: 

lbo: dro: 

syo: dro: 



>> An alternate version of SYSLIB.OLB» the system object library* was 

>f created to provide support for ANSI msStape/FCS b i s-buf f e r i na (which 

>i sou selected in Phase I). You may want to rebuild DMP> FLX . PIP, and 

>i vTY in Phase III to use ANSLIB.OLB. Note» however, building tpsks with 

>i ANSLIB.OLB causes an increase in the size of tasks as compared to the 

>f SYSLIB.OLB version of the tasks. 



>f A memory resident library of FCS routines (which you selected in Phase I) 

>i was built to help reduce task memory retirements. You may want to rcbui 

>i tasks in Phase III to link to the FCS resident library. 

>f When SYSGEN finishes? boot in your tercet system* and save the system wit 

>r bootstrap. For example • 

>i : BOO Cl»543RSXliM 

>i XDT! 32 

r 

>i XDT>G 

>i RSX11M V4.0 BL32 



>i >TIM 11J23 14-0CT-81 

>t >SAV /WB 

■ ; ' f 

>t RSX11M U4.0 BL32 320. K HAPPED 

>i >red dr:=sy: 

>f >RED drj=lbj 

>} >M0U DR .' RSXM32 

>i >@DR J CI 1 2 3 ST ARTUP 



> > End of system VHP at 12:33151 on 21-JAN-82 



■ASM =lb: 



End of SYSGEN phase II at 12:34100 on 21-JAN-82 



■■ 7 

■SET /UIC=C200»2003 
Q <E0F> 



BOO C 1 j 54 ]RSX 1 1 rt 
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SET /UIC=C11»23 
•0PMONBLD 

* ENTER KW11-P VECTOR ADDRESS CO R ! 100-774 DJ104DS 

•* ENTER KUU-P CSR ADDRESS CO R ! 1 60000- 1 77776 D ! 1725403 ! 
■■* WILL THE BUFFERS BE IN A STATIC PARTITION? CY/N3? 
•TKB 8C0LBLD 
•TKB STRMBLD 
•TKB 0COLMSGBLD 

SET /UIC=Clr543 
■TKB (»C11 r 23GPDRVBLD 

SET /UIC=C11»23 

■■■) Taskbuild the MDR > OVL S CLF Programs. 

* EIS or FPP <FPP> CSK 

; - f 

* Do you wish to build the task OVL? C Y / N 3 S 

'• r 

* Do you wish to build the task CLF? CY/N3! 

: - r 

* Do you wish to build the task MDR? CY/NK Y 

* Build Overlaid Version of MDR.TSK? CY/NDJ Y 

* Do you want to edit the MDR taskbuild command file? C Y/NH J 
TKB 8MDRFPP0VL 

(? <E0F> 



INS COL 
•INS TRM 
>INS COLMSG 

■LOA qp:/par=gen/high 

■INS OVL 

;-INS CLF 

■INS MDR 

>INS DRS 
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